Swift API reference

public final class OMSWallet: Sendable {
    public let wallet: WalletClient
    public let indexer: IndexerClient
    /// Creating `OMSWallet` again for the same project and environment returns the same `wallet`:
    /// one session, active wallet, expiry timer, and set of observers per project in the process,
    /// so instances cannot drift apart. A publishable key with another key ID for the same project
    /// (a rotated key) keeps that session and is used for later requests. Another project or
    /// environment is a separate session.
    public convenience init(publishableKey: String) throws
}

public final class WalletClient: @unchecked Sendable

public internal(set) var activeWallet: Wallet? { get set }

public var session: OMSWalletSession? { get }

public static let defaultSessionLifetimeSeconds: UInt32

public static let maxSessionLifetimeSeconds: UInt32

public func addSessionChangeObserver(_ observer: @escaping @MainActor @Sendable (OMSWalletSessionChangeEvent) -> Void) -> OMSWalletSessionChangeObservation

public func startEmailAuth(email: String, sessionLifetimeSeconds: UInt32 = WalletClient.defaultSessionLifetimeSeconds) async throws

@discardableResult public func completeEmailAuth(code: String, walletSelection: WalletSelectionBehavior = .automatic, walletType: WalletType = WalletType.ethereum) async throws -> CompleteAuthResult

@discardableResult public func signInWithOidcIdToken(idToken: String, issuer: String, audience: String, walletType: WalletType = WalletType.ethereum, walletSelection: WalletSelectionBehavior = .automatic, sessionLifetimeSeconds: UInt32 = WalletClient.defaultSessionLifetimeSeconds, provider: String? = nil, providerLabel: String? = nil) async throws -> CompleteAuthResult

public func startOIDCRedirectAuth(provider: CustomOIDCProviderConfiguration, walletType: WalletType = WalletType.ethereum, walletSelection: WalletSelectionBehavior? = nil, sessionLifetimeSeconds: UInt32? = nil, loginHint: String? = nil, authorizeParams: [String : String] = [:]) async throws -> StartOIDCRedirectAuthResult

public func startOIDCRedirectAuth(provider: OMSRelayOIDCProvider, omsRelayReturnURI: String, walletType: WalletType = WalletType.ethereum, walletSelection: WalletSelectionBehavior? = nil, sessionLifetimeSeconds: UInt32? = nil, loginHint: String? = nil) async throws -> StartOIDCRedirectAuthResult

public func handleOIDCRedirectCallback(_ callbackURL: String?, walletSelection: WalletSelectionBehavior? = nil, sessionLifetimeSeconds: UInt32? = nil) async throws -> OIDCRedirectAuthResult

public func listWallets() async throws -> [Wallet]

@discardableResult public func useWallet(walletId: String) async throws -> WalletActivationResult

@discardableResult public func createWallet(walletType: WalletType = WalletType.ethereum, reference: String? = nil) async throws -> WalletActivationResult

@discardableResult public func claimWallet(walletId: String) async throws -> WalletActivationResult

@discardableResult public func importWallet(privateKey: WalletImportPrivateKey, reference: String? = nil) async throws -> WalletActivationResult

public func getWalletImportRecipientKey(cipherSuite: WalletImportCipherSuite) async throws -> WalletImportRecipientKey

@discardableResult public func importEncryptedWallet(walletType: WalletType, keyMaterial: EncryptedWalletImportKeyMaterial, reference: String? = nil) async throws -> WalletActivationResult

public func getIdToken(ttlSeconds: UInt32? = nil, customClaims: [String : JSONValue]? = nil) async throws -> String

public func inspectRemoteCredential(credentialId: String) async throws -> RemoteCredentialMetadata

public func authorizeRemoteAccess(credentialId: String, network: Network, grants: [SmartSessionGrant], expiresAt: String, sessionId: String? = nil) async throws -> AuthorizedRemoteAccess

public func listAccess(pageSize: UInt32? = nil, type: AccessGrantType? = nil) async throws -> [AccessGrant]

public func listAccessPage(pageSize: UInt32? = nil, cursor: String? = nil, type: AccessGrantType? = nil) async throws -> AccessGrantPage

public func listAccessPages(pageSize: UInt32? = nil, type: AccessGrantType? = nil) -> ListAccessPages

public func getRemoteAccessSession(sessionId: String) async throws -> RemoteAccessSession

public func getRemoteAccessSessionUsage(sessionId: String, network: Network) async throws -> [SmartSessionGrantUsage]

public func revokeAccess(credentialId: String, sessionId: String? = nil) async throws

public func signOut() throws

public enum WalletSelectionBehavior: String, Codable, Equatable, Sendable {
    case automatic
    case manual
    public init?(rawValue: String)
}

public enum CompleteAuthResult: Sendable {
    /// A wallet was activated. `wallets` lists the user's wallets, and `claimableWallets` lists
    /// the wallets preallocated for the user that this sign-in did not claim.
    case walletSelected(
        wallet: Wallet,
        wallets: [Wallet],
        claimableWallets: [Wallet],
        credential: WalletCredential
    )
    case walletSelection(PendingWalletSelection)
    public var credential: WalletCredential { get }
    public var wallet: Wallet? { get }
    /// Wallets preallocated for the user that they can claim with
    /// `WalletClient.claimWallet(walletId:)`: the unclaimed ones after `.walletSelected`, or
    /// `PendingWalletSelection.claimableWallets` for `.walletSelection`.
    public var claimableWallets: [Wallet] { get }
}

public final class PendingWalletSelection: @unchecked Sendable {
    public let walletType: WalletType
    public let wallets: [Wallet]
    /// Wallets of `walletType` preallocated for the signed-in user that they can claim with
    /// `WalletClient.claimWallet(walletId:)`.
    public let claimableWallets: [Wallet]
    public let credential: WalletCredential
    @discardableResult public func selectWallet(walletId: String) async throws -> WalletActivationResult
    @discardableResult public func createAndSelectWallet(reference: String? = nil) async throws -> WalletActivationResult
    /// Claims one of `claimableWallets` and selects it, completing this selection.
    @discardableResult public func claimAndSelectWallet(walletId: String) async throws -> WalletActivationResult
}

public struct WalletActivationResult: Sendable {
    public let wallet: Wallet
    public init(wallet: Wallet)
}

public struct Wallet: Codable, Equatable, Sendable {
    public let id: String
    public let type: WalletType
    public let address: String
    public let reference: String?
    public let keyOrigin: WalletKeyOrigin
    public init(id: String, type: WalletType, address: String, reference: String? = nil, keyOrigin: WalletKeyOrigin)
    public init(from decoder: any Decoder) throws
}

public enum WalletType: Codable, Equatable, Hashable, Sendable {
    case ethereum
    case solana
    case tron
    case unknown(String)
    public var wireValue: String { get }
    public init(wireValue: String)
    public init(from decoder: Decoder) throws
    public func encode(to encoder: Encoder) throws
}

public enum WalletKeyOrigin: Codable, Equatable, Hashable, Sendable {
    case enclave
    case imported
    case unknown(String)
    public var wireValue: String { get }
    public init(wireValue: String)
    public init(from decoder: Decoder) throws
    public func encode(to encoder: Encoder) throws
}

public enum WalletImportCipherSuite: String, CaseIterable, Sendable {
    case x25519Sha256Aes256Gcm = "x25519-sha256-aes256gcm"
    case x25519Sha256ChaCha20Poly1305 = "x25519-sha256-chacha20poly1305"
    case p256Sha256Aes256Gcm = "p256-sha256-aes256gcm"
    case p256Sha256ChaCha20Poly1305 = "p256-sha256-chacha20poly1305"
    public init?(rawValue: String)
}

public enum WalletImportPrivateKey: Sendable, CustomStringConvertible, CustomDebugStringConvertible, CustomReflectable {
    case ethereum(String)
    case ethereumBytes(Data)
    case solana(String)
    case solanaBytes(Data)
    /// A secp256k1 private key as 64 hexadecimal characters, optionally `0x`-prefixed. Tron uses
    /// the same private key format as Ethereum.
    case tron(String)
    /// A 32-byte secp256k1 private key.
    case tronBytes(Data)
    public var walletType: WalletType { get }
    public var description: String { get }
    public var debugDescription: String { get }
    public var customMirror: Mirror { get }
}

public struct WalletImportRecipientKey: Equatable, Sendable {
    public let keyId: String
    public let cipherSuite: WalletImportCipherSuite
    public let publicKey: String
    public init(keyId: String, cipherSuite: WalletImportCipherSuite, publicKey: String)
}

public struct EncryptedWalletImportKeyMaterial: Equatable, Sendable {
    public let keyId: String
    public let cipherSuite: WalletImportCipherSuite
    public let encapsulatedKey: String
    public let ciphertext: String
    public init(keyId: String, cipherSuite: WalletImportCipherSuite, encapsulatedKey: String, ciphertext: String)
}

public struct WalletCredential: Codable, Equatable, Sendable {
    public let credentialId: String
    /// The credential's current expiry when it was returned, as an ISO-8601 timestamp. The server
    /// extends it with use up to the requested session lifetime, and the SDK refreshes the active
    /// session's copy in `OMSWalletSession.expiresAt`.
    public let expiresAt: String
    public let isCaller: Bool
    public init(credentialId: String, expiresAt: String, isCaller: Bool)
    public init(from decoder: any Decoder) throws
}

public struct RemoteCredentialMetadata: Codable, Equatable, Sendable {
    public let appUrl: String
    public let appName: String
    public let appLogoUrl: String
    public let custom: [String : String]
    public init(appUrl: String, appName: String, appLogoUrl: String, custom: [String : String])
    public init(from decoder: any Decoder) throws
}

public enum SmartSessionGrant: Equatable, Sendable {
    case nativeTransfer(to: String, limit: String)
    case erc20Transfer(token: String, to: String? = nil, limit: String, cumulative: Bool? = nil)
}

public enum AccessGrantType: String, Codable, Equatable, Sendable {
    case direct
    case remote
    public init?(rawValue: String)
}

public struct RemoteAccessGrant: Equatable, Sendable {
    public let credential: WalletCredential
    public let sessionId: String
    public let metadata: RemoteCredentialMetadata
    public let grants: [SmartSessionGrant]
    public init(credential: WalletCredential, sessionId: String, metadata: RemoteCredentialMetadata, grants: [SmartSessionGrant])
}

public enum AccessGrant: Equatable, Sendable {
    case direct(WalletCredential)
    case remote(RemoteAccessGrant)
    public var credential: WalletCredential { get }
}

public struct AccessGrantPage: Equatable, Sendable {
    public let grants: [AccessGrant]
    public let page: Page?
    public init(grants: [AccessGrant], page: Page? = nil)
}

public struct AuthorizedRemoteAccess: Equatable, Sendable {
    public let walletId: String
    public let sessionId: String
    public let expiresAt: String
}

public struct RemoteAccessSession: Equatable, Sendable {
    public let sessionId: String
    public let walletId: String
    public let signerAddress: String
    public let grants: [SmartSessionGrant]
    public let chainId: Int
    public let expiresAt: String
}

public struct SmartSessionGrantUsage: Equatable, Sendable {
    public let grant: SmartSessionGrant
    public let used: String?
}

public struct CustomOIDCProviderConfiguration: Sendable {
    public let issuer: String
    public let clientID: String
    public let authorizationURL: String
    public let provider: String?
    public let providerLabel: String?
    public let scopes: [String]
    public let providerRedirectURI: String
    public let authorizeParams: [String : String]
    public let authMode: OIDCAuthMode
    public init(issuer: String, clientID: String, authorizationURL: String, providerRedirectURI: String, provider: String? = nil, providerLabel: String? = nil, scopes: [String] = [], authorizeParams: [String : String] = [:], authMode: OIDCAuthMode = .authCodePKCE)
}

public enum OIDCAuthMode: String, Codable, Equatable, Sendable {
    case authCode = "auth-code"
    case authCodePKCE = "auth-code-pkce"
    public init?(rawValue: String)
}

public struct OMSRelayOIDCProvider: Equatable, Hashable, Sendable

public enum OMSRelayOIDCProviders {
    public static let google: OMSRelayOIDCProvider
    public static let apple: OMSRelayOIDCProvider
}

public struct StartOIDCRedirectAuthResult: Sendable {
    public let authorizationURL: String
    public init(authorizationURL: String)
}

public enum OIDCRedirectAuthResult: Sendable {
    case completed(CompleteAuthResult)
    case notOIDCRedirectCallback
    case noPendingAuth
}

public struct OMSWalletSession: Equatable, Sendable {
    /// The current expiry of the active wallet session, as the ISO-8601 timestamp returned by the
    /// wallet API. The server extends it with use up to the requested session lifetime, and the
    /// SDK refreshes it, so it can be later than the sign-in `WalletCredential.expiresAt`.
    public let expiresAt: String
    /// Auth metadata for the active wallet session.
    public let auth: OMSWalletSessionAuth
    public init(expiresAt: String, auth: OMSWalletSessionAuth)
}

public enum OMSWalletSessionAuth: Codable, Equatable, Sendable {
    case email(OMSWalletEmailSessionAuth)
    case oidc(OMSWalletOidcSessionAuth)
    public var email: String? { get }
    public init(from decoder: Decoder) throws
    public func encode(to encoder: Encoder) throws
}

public struct OMSWalletEmailSessionAuth: Codable, Equatable, Sendable {
    public let email: String
    public init(email: String)
    public init(from decoder: Decoder) throws
    public func encode(to encoder: Encoder) throws
}

public struct OMSWalletOidcSessionAuth: Codable, Equatable, Sendable {
    public let flow: OMSWalletOidcSessionAuthFlow
    public let issuer: String
    public let provider: String?
    public let providerLabel: String?
    public let email: String?
    public init(flow: OMSWalletOidcSessionAuthFlow, issuer: String, provider: String? = nil, providerLabel: String? = nil, email: String? = nil)
    public init(from decoder: Decoder) throws
    public func encode(to encoder: Encoder) throws
}

public enum OMSWalletOidcSessionAuthFlow: String, Codable, Equatable, Sendable {
    case redirect
    case idToken = "id-token"
    public init?(rawValue: String)
}

public enum OMSWalletSessionChangeEvent: Equatable, Sendable {
    /// A sign-in made a wallet active.
    case signedIn(wallet: Wallet, session: OMSWalletSession)
    /// A session saved on this device became active after the client was created, for example once
    /// the device was unlocked after a launch while it was locked. Treat it like `signedIn`; the
    /// user did not just sign in.
    case restored(wallet: Wallet, session: OMSWalletSession)
    /// Another wallet of the same sign-in became active.
    case walletChanged(wallet: Wallet, session: OMSWalletSession)
    /// `session.expiresAt` moved. Safe to ignore unless you show the expiry.
    case expiryUpdated(wallet: Wallet, session: OMSWalletSession)
    /// There is no session any more and it did not expire: `signOut()`, a sign-in started while
    /// signed in, or another process sharing the keychain signing in. Not necessarily the user's
    /// choice.
    case signedOut
    /// The session expired, or the wallet API no longer accepts it.
    case expired(OMSWalletExpiredSession)
    /// The active wallet after the change; `nil` for `signedOut` and `expired`.
    public var activeWallet: Wallet? { get }
    /// The session after the change; non-`nil` exactly when `activeWallet` is.
    public var session: OMSWalletSession? { get }
}

public struct OMSWalletExpiredSession: Equatable, Sendable {
    /// The wallet that was active when the session expired, or `nil` when the credential expired
    /// while a manual wallet selection was still pending.
    public let wallet: Wallet?
    public let session: OMSWalletSession
    /// The ISO-8601 time the session ended: its expiry, or, when the SDK found it ended before its
    /// expiry (for example after another process's session ended it), the time that was found.
    public let expiredAt: String
    public init(wallet: Wallet?, session: OMSWalletSession, expiredAt: String)
}

public final class OMSWalletSessionChangeObservation: @unchecked Sendable {
    public func cancel()
}

public struct ListAccessPages: AsyncSequence {
    public typealias Element = AccessGrantPage
    public func makeAsyncIterator() -> AsyncIterator
    public struct AsyncIterator: AsyncIteratorProtocol {
        public mutating func next() async throws -> AccessGrantPage?
    }
}

public func signMessage(network: Network, message: String) async throws -> String

public func signSolanaMessage(message: String) async throws -> String

public func signTypedData(network: Network, typedData: JSONValue) async throws -> String

public func signTronMessage(message: String) async throws -> String

public func signTronTypedData(typedData: JSONValue) async throws -> String

public func isValidMessageSignature(network: Network, walletAddress: String? = nil, message: String, signature: String) async throws -> Bool

public func isValidSolanaMessageSignature(walletAddress: String? = nil, message: String, signature: String) async throws -> Bool

public func isValidTypedDataSignature(network: Network, walletAddress: String? = nil, typedData: JSONValue, signature: String) async throws -> Bool

public func isValidTronMessageSignature(walletAddress: String? = nil, message: String, signature: String) async throws -> Bool

public func isValidTronTypedDataSignature(walletAddress: String? = nil, typedData: JSONValue, signature: String) async throws -> Bool

public func sendTransaction(network: Network, to: String, value: String, selectFeeOption: FeeOptionSelector? = nil, mode: TransactionMode = .relayer, waitForStatus: Bool = true, statusPolling: TransactionStatusPollingOptions = TransactionStatusPollingOptions()) async throws -> SendTransactionResponse

public func sendTransaction(network: Network, request: SendTransactionRequest, selectFeeOption: FeeOptionSelector? = nil, waitForStatus: Bool = true, statusPolling: TransactionStatusPollingOptions = TransactionStatusPollingOptions()) async throws -> SendTransactionResponse

public func sendSolanaTransfer(network: SolanaNetwork, asset: String, to: String, amount: String, selectFeeOption: FeeOptionSelector? = nil, mode: TransactionMode = .relayer, waitForStatus: Bool = true, statusPolling: TransactionStatusPollingOptions = TransactionStatusPollingOptions()) async throws -> SendTransactionResponse

public func sendTronTransaction(network: TronNetwork, to: String, value: String = "0", data: String? = nil, selectFeeOption: FeeOptionSelector? = nil, waitForStatus: Bool = true, statusPolling: TransactionStatusPollingOptions = TransactionStatusPollingOptions()) async throws -> SendTransactionResponse

public func callContract(network: Network, contractAddress: String, method: String, args: [AbiArg]? = nil, selectFeeOption: FeeOptionSelector? = nil, mode: TransactionMode = .relayer, waitForStatus: Bool = true, statusPolling: TransactionStatusPollingOptions = TransactionStatusPollingOptions()) async throws -> SendTransactionResponse

public func callTronContract(network: TronNetwork, contractAddress: String, method: String, args: [AbiArg]? = nil, selectFeeOption: FeeOptionSelector? = nil, waitForStatus: Bool = true, statusPolling: TransactionStatusPollingOptions = TransactionStatusPollingOptions()) async throws -> SendTransactionResponse

public func getTransactionStatus(txnId: String) async throws -> TransactionStatusResponse

public struct SendTransactionRequest: Sendable {
    public let to: String
    public let value: String
    public let data: String?
    public let mode: TransactionMode
    public init(to: String, value: String, data: String? = nil, mode: TransactionMode = .relayer)
}

public struct SendTransactionResponse: Codable, Sendable, Equatable {
    public let txnId: String
    public let status: TransactionStatus
    public let txnHash: String?
    public let statusResolution: TransactionStatusResolution
    public init(txnId: String, status: TransactionStatus, txnHash: String? = nil, statusResolution: TransactionStatusResolution)
    public init(from decoder: any Decoder) throws
}

public enum TransactionMode: Codable, Equatable, Hashable, Sendable {
    case native
    case relayer
    case unknown(String)
    public var wireValue: String { get }
    public init(wireValue: String)
    public init(from decoder: Decoder) throws
    public func encode(to encoder: Encoder) throws
}

public struct TransactionStatusPollingOptions: Sendable, Equatable {
    public let timeoutMs: UInt64?
    public let intervalMs: UInt64?
    public let fastIntervalMs: UInt64?
    public let fastPollCount: Int?
    public init(timeoutMs: UInt64? = nil, intervalMs: UInt64? = nil, fastIntervalMs: UInt64? = nil, fastPollCount: Int? = nil)
}

public struct TransactionStatusResponse: Codable, Equatable, Sendable {
    public let status: TransactionStatus
    public let txnHash: String?
    public init(status: TransactionStatus, txnHash: String? = nil)
    public init(from decoder: any Decoder) throws
}

public enum TransactionStatus: Codable, Equatable, Hashable, Sendable {
    case quoted
    case pending
    case executed
    case failed
    case unknown(String)
    public var wireValue: String { get }
    public init(wireValue: String)
    public init(from decoder: Decoder) throws
    public func encode(to encoder: Encoder) throws
}

public enum TransactionStatusResolution: String, Codable, Sendable, Equatable {
    case notRequested
    case resolved
    case timedOut
    public init?(rawValue: String)
}

public struct FeeOptionSelector: Sendable {
    /// Sponsored transactions pass an empty array. Returning `nil` acknowledges the free fee;
    /// throw to stop execution.
    public typealias Select = @Sendable (_ options: [FeeOptionWithBalance]) async throws -> FeeOptionSelection?
    public init(_ select: @escaping Select)
    public func callAsFunction(_ options: [FeeOptionWithBalance]) async throws -> FeeOptionSelection?
    public func callAsFunction(_ options: [FeeOption]) async throws -> FeeOptionSelection?
    public static let firstAvailable: FeeOptionSelector
    public static func custom(_ pick: @escaping Select) -> FeeOptionSelector
}

public struct FeeOptionWithBalance: Sendable {
    public let feeOption: FeeOption
    public let selection: FeeOptionSelection
    public let balance: TokenBalance?
    public let available: String?
    public let availableRaw: String?
    public let decimals: Int?
    public init(feeOption: FeeOption, selection: FeeOptionSelection? = nil, balance: TokenBalance? = nil, available: String? = nil, availableRaw: String? = nil, decimals: Int? = nil)
}

public struct FeeOption: Codable, Equatable, Sendable {
    public let token: FeeToken
    public let value: String
    public let displayValue: String
    public init(token: FeeToken, value: String, displayValue: String)
    public init(from decoder: any Decoder) throws
}

public struct FeeOptionSelection: Codable, Equatable, Sendable {
    public let token: String
    public let index: UInt32?
    public init(token: String, index: UInt32? = nil)
    public init(feeOption: FeeOption, index: UInt32? = nil)
    public init(from decoder: any Decoder) throws
}

public struct FeeToken: Codable, Equatable, Sendable {
    public let network: String
    public let name: String
    public let symbol: String
    public let type: String
    public let decimals: UInt32?
    public let logoUrl: String?
    public let contractAddress: String?
    public let tokenId: String?
    public init(network: String, name: String, symbol: String, type: String, decimals: UInt32? = nil, logoUrl: String? = nil, contractAddress: String? = nil, tokenId: String? = nil)
    public init(from decoder: any Decoder) throws
}

public struct AbiArg: Codable, Equatable, Sendable {
    public let type: String
    public let value: JSONValue
    public init(type: String, value: JSONValue)
    public init(from decoder: any Decoder) throws
}

public final class IndexerClient: Sendable

public func getBalances(_ params: GetBalancesParams) async throws -> BalancesResult

public func getTransactionHistory(_ params: GetTransactionHistoryParams) async throws -> TransactionHistoryResult

public func getSolanaBalances(_ params: GetSolanaBalancesParams) async throws -> SolanaBalancesResult

public struct GetSolanaBalancesParams: Sendable {
    public let walletAddress: String
    public let networks: [SolanaNetwork]
    public let includeMetadata: Bool
    public let omitNativeBalances: Bool?
    public let mintAddresses: [String]
    public let excludedMintAddresses: [String]
    public init(walletAddress: String, networks: [SolanaNetwork] = [.mainnet, .devnet], includeMetadata: Bool = true, omitNativeBalances: Bool? = nil, mintAddresses: [String] = [], excludedMintAddresses: [String] = [])
}

public struct SolanaBalancesResult: Sendable {
    public let status: Int
    public let balances: [SolanaBalance]
    public let errors: [SolanaNetworkError]
}

public enum SolanaBalance: Decodable, Sendable {
    case native(SolanaNativeBalance)
    case fungibleToken(SolanaFungibleTokenBalance)
    public init(from decoder: Decoder) throws
    public var network: SolanaNetwork { get }
    public var accountAddress: String { get }
    public var name: String { get }
    public var symbol: String { get }
    public var decimals: Int { get }
    public var balance: String { get }
    public var formattedBalance: String { get }
    public var imageUrl: String? { get }
    public var metadataUri: String? { get }
    public var verificationStatus: SolanaVerificationStatus { get }
    public var verificationSource: SolanaVerificationSource { get }
    public var priceUSD: String? { get }
    public var balanceUSD: String? { get }
}

public struct SolanaNativeBalance: Codable, Sendable {
    public let network: SolanaNetwork
    public let accountAddress: String
    public let name: String
    public let symbol: String
    public let decimals: Int
    public let balance: String
    public let formattedBalance: String
    public let imageUrl: String?
    public let metadataUri: String?
    public let verificationStatus: SolanaVerificationStatus
    public let verificationSource: SolanaVerificationSource
    public let priceUSD: String?
    public let balanceUSD: String?
    public init(from decoder: any Decoder) throws
}

public struct SolanaFungibleTokenBalance: Codable, Sendable {
    public let network: SolanaNetwork
    public let accountAddress: String
    public let tokenProgram: SolanaTokenProgram
    public let mintAddress: String
    public let name: String
    public let symbol: String
    public let decimals: Int
    public let balance: String
    public let formattedBalance: String
    public let imageUrl: String?
    public let metadataUri: String?
    public let verificationStatus: SolanaVerificationStatus
    public let verificationSource: SolanaVerificationSource
    public let priceUSD: String?
    public let balanceUSD: String?
    public init(from decoder: any Decoder) throws
}

public struct SolanaNetworkError: Codable, Sendable {
    public let network: SolanaNetwork
    public let reason: String
    public init(from decoder: any Decoder) throws
}

public enum SolanaVerificationStatus: String, Codable, Sendable {
    case verified
    case unverified
    case unknown
    public init?(rawValue: String)
}

public enum SolanaVerificationSource: String, Codable, Sendable {
    case jupiter
    case solflareUtl = "solflare-utl"
    case none
    public init?(rawValue: String)
}

public enum SolanaTokenProgram: String, Codable, Sendable {
    case splToken = "spl-token"
    case token2022 = "token-2022"
    public init?(rawValue: String)
}

public func getTronBalances(_ params: GetTronBalancesParams) async throws -> TronBalancesResult

public struct GetTronBalancesParams: Sendable {
    /// Base58Check (`T…`) wallet address.
    public let walletAddress: String
    public let networks: [TronNetwork]
    public let includeMetadata: Bool
    public let omitNativeBalances: Bool?
    /// Only return these TRC-20 contracts (`T…`).
    public let contractAddresses: [String]
    /// Exclude these TRC-20 contracts (`T…`).
    public let excludedContractAddresses: [String]
    public init(walletAddress: String, networks: [TronNetwork] = [.mainnet, .nile], includeMetadata: Bool = true, omitNativeBalances: Bool? = nil, contractAddresses: [String] = [], excludedContractAddresses: [String] = [])
}

public struct TronBalancesResult: Sendable {
    public let status: Int
    public let balances: [TronBalance]
    public let errors: [TronNetworkError]
}

public enum TronBalance: Decodable, Sendable {
    case native(TronNativeBalance)
    case fungibleToken(TronFungibleTokenBalance)
    public init(from decoder: Decoder) throws
    public var network: TronNetwork { get }
    public var accountAddress: String { get }
    public var name: String { get }
    public var symbol: String { get }
    public var decimals: Int { get }
    public var balance: String { get }
    public var formattedBalance: String { get }
    public var imageUrl: String? { get }
    public var metadataUri: String? { get }
    public var verificationStatus: TronVerificationStatus { get }
    public var verificationSource: String { get }
    public var priceUSD: String? { get }
    public var balanceUSD: String? { get }
}

public struct TronNativeBalance: Codable, Sendable {
    public let network: TronNetwork
    /// Base58Check (`T…`) account address.
    public let accountAddress: String
    public let name: String
    public let symbol: String
    public let decimals: Int
    /// Raw balance in sun (1 TRX = 1,000,000 sun).
    public let balance: String
    public let formattedBalance: String
    public let imageUrl: String?
    public let metadataUri: String?
    public let verificationStatus: TronVerificationStatus
    public let verificationSource: String
    public let priceUSD: String?
    public let balanceUSD: String?
    public init(from decoder: Decoder) throws
}

public struct TronFungibleTokenBalance: Codable, Sendable {
    public let network: TronNetwork
    /// Base58Check (`T…`) account address.
    public let accountAddress: String
    public let tokenStandard: TronTokenStandard
    /// Base58Check (`T…`) TRC-20 contract address.
    public let contractAddress: String
    public let name: String
    public let symbol: String
    public let decimals: Int
    /// Raw balance in the token's base units.
    public let balance: String
    public let formattedBalance: String
    public let imageUrl: String?
    public let metadataUri: String?
    public let verificationStatus: TronVerificationStatus
    public let verificationSource: String
    public let priceUSD: String?
    public let balanceUSD: String?
    public init(from decoder: Decoder) throws
}

public struct TronNetworkError: Codable, Sendable {
    public let network: TronNetwork
    public let reason: String
    public init(from decoder: any Decoder) throws
}

public enum TronVerificationStatus: String, Codable, Sendable {
    case verified
    case unverified
    case unknown
    public init?(rawValue: String)
}

public enum TronTokenStandard: String, Codable, Sendable {
    case trc20
    public init?(rawValue: String)
}

public struct GetBalancesParams: Sendable {
    public let walletAddress: String
    public let networks: [Network]?
    public let networkType: IndexerNetworkType?
    public let contractAddresses: [String]?
    public let includeMetadata: Bool
    public let omitPrices: Bool?
    public let tokenIds: [String]?
    public let contractStatus: ContractVerificationStatus?
    public let page: TokenBalancesPageRequest?
    public init(walletAddress: String, networks: [Network]? = nil, networkType: IndexerNetworkType? = nil, contractAddresses: [String]? = nil, includeMetadata: Bool = true, omitPrices: Bool? = nil, tokenIds: [String]? = nil, contractStatus: ContractVerificationStatus? = nil, page: TokenBalancesPageRequest? = nil)
}

public struct BalancesResult: Sendable {
    public let status: Int
    public let page: TokenBalancesPage?
    public let nativeBalances: [NativeTokenBalance]
    public let balances: [ContractTokenBalance]
    public init(status: Int, page: TokenBalancesPage?, nativeBalances: [NativeTokenBalance], balances: [ContractTokenBalance])
}