CROSSx iOS SDK

Native Swift SDK for OAuth authentication, embedded wallet management, and EVM RPC access.

What you can do

• Authenticate users with OAuth (Google / Apple) or JWT token injection
• One-step login + wallet creation (signInWithCreate)
• Restore/refresh session state (initialize, ensureLoggedIn, refreshToken)
• Get wallet addresses, create wallet, and select HD wallet
• Verify wallet status (checkWallet) and PIN (verifyPassword)
• Sign message / typed data / transaction via SDK confirmation UI
• Send transaction and wait for receipt
• Use RPC helpers (walletRpc, getBalance, getTokenBalance, getNonce)
• Protect PIN with biometric authentication (Face ID / Touch ID)
• Customize theme (Light / Dark / System, semantic color tokens)

Quick start path

1. Getting Started
   Install SDK, configure callback scheme, create CROSSxSDK.
2. Authentication
   Implement callback handling, login methods, and session lifecycle.
3. Wallet
   Integrate sign/send, receipt polling, and chain management.
4. API Reference
   Check full signatures and object details.

Minimum integration example

let config = SDKConfig(
    projectId: "your-project-id",
    appName: "My App"
)
let sdk = try CROSSxSDK(config: config)

Notes

• Chain routing is explicit for wallet/RPC flows (chainId required where applicable, use eip155:<number> such as eip155:612044).
• walletRpc is call/read oriented (for example eth_call), not transaction sign/send.
• CROSSxPrivateSDK provides sensitive operations (mnemonic, private key, withdraw, Share-C recovery) and requires a separate HMAC key.