SolanaWallet

Defined in: packages/wallets/src/wallets/solana.ts:17

Extends

• Wallet<SolanaChain>

Constructors

new SolanaWallet()

new SolanaWallet(wallet): SolanaWallet

Defined in: packages/wallets/src/wallets/solana.ts:18

Parameters

Parameter	Type
wallet	Wallet<"solana">

Returns

SolanaWallet

Overrides

Wallet.constructor

Properties

Property	Type	Inherited from	Defined in
address	string	Wallet.address	packages/wallets/src/wallets/wallet.ts:91
alias?	string	Wallet.alias	packages/wallets/src/wallets/wallet.ts:93
chain	"solana"	Wallet.chain	packages/wallets/src/wallets/wallet.ts:90
owner?	string	Wallet.owner	packages/wallets/src/wallets/wallet.ts:92

Accessors

apiClient

Get Signature

get apiClient(): WalletsApiClient

Defined in: packages/wallets/src/wallets/wallet.ts:273

Returns

WalletsApiClient

Inherited from

Wallet.apiClient

---

recovery

Get Signature

get recovery(): SignerConfigForChain<C>

Defined in: packages/wallets/src/wallets/wallet.ts:298

Experimental

Get the primary recovery signer config. Use recoveryMethods for the full list on wallets created with several recovery signers.

Returns

SignerConfigForChain<C>

The recovery signer config This API is experimental and may change in the future

Inherited from

Wallet.recovery

---

recoveryMethods

Get Signature

get recoveryMethods(): RecoverySignerConfigForChain<C>[]

Defined in: packages/wallets/src/wallets/wallet.ts:308

Experimental

Get every recovery signer config of the wallet. Wallets on chains that support a single recovery signer always return one entry.

Returns

RecoverySignerConfigForChain<C>[]

The recovery signer configs This API is experimental and may change in the future

Inherited from

Wallet.recoveryMethods

---

signer

Get Signature

get signer(): SignerAdapter<keyof SignResultMap> | undefined

Defined in: packages/wallets/src/wallets/wallet.ts:178

Returns

SignerAdapter<keyof SignResultMap> | undefined

Inherited from

Wallet.signer

Methods

addSigner()

addSigner<T>(signer, options?): Promise<T extends PrepareOnly<true> ? Signer & object : Signer>

Defined in: packages/wallets/src/wallets/wallet.ts:623

Add a signer to the wallet. Always uses the recovery signer internally to approve the registration. If the signer being added is the current operational signer, it will be reassembled with the new locator. Otherwise, the original signer is restored after the operation.

Type Parameters

Type Parameter	Default type
T extends AddSignerOptions | undefined	undefined

Parameters

Parameter	Type	Description
signer	ExternalWalletRegistrationConfig | EmailSignerConfig | PhoneSignerConfig | DeviceSignerConfig | BaseSignerConfig<"solana">	The signer configuration object
options?	T	The options for the operation

Returns

Promise<T extends PrepareOnly<true> ? Signer & object : Signer>

Inherited from

Wallet.addSigner

---

approve()

approve<T>(params): Promise<ApproveResult<T>>

Defined in: packages/wallets/src/wallets/wallet.ts:576

Approve a transaction or signature

Type Parameters

Type Parameter
T extends ApproveParams

Parameters

Parameter	Type	Description
params	T	The parameters

Returns

Promise<ApproveResult<T>>

The transaction or signature

Inherited from

Wallet.approve

---

approveTransaction()

approveTransaction(params): Promise<Error>

Defined in: packages/wallets/src/wallets/wallet.ts:552

Parameters

Parameter	Type	Description
params	ApproveParams	The parameters

Returns

Promise<Error>

The transaction

Deprecated

Use approve instead. Approve a transaction

Inherited from

Wallet.approveTransaction

---

balances()

balances(tokens?): Promise<Balances<"solana">>

Defined in: packages/wallets/src/wallets/wallet.ts:325

Get the wallet balances - always includes USDC and native token (ETH/SOL)

Parameters

Parameter	Type	Description
tokens?	string[]	Additional tokens to request (optional: native token and usdc are always included)

Returns

Promise<Balances<"solana">>

The balances returns nativeToken, usdc, tokens

Throws

If the balances cannot be retrieved

Inherited from

Wallet.balances

---

isSignerApproved()

isSignerApproved(signerLocator): Promise<boolean>

Defined in: packages/wallets/src/wallets/wallet.ts:997

Check if a signer is approved and usable for the current wallet chain.

Parameters

Parameter	Type	Description
signerLocator	string	The locator of the signer to check

Returns

Promise<boolean>

true if the signer is approved for this chain, false if it is not approved or not registered

Throws

if the approval state could not be fetched

Inherited from

Wallet.isSignerApproved

---

needsRecovery()

needsRecovery(): boolean

Defined in: packages/wallets/src/wallets/wallet.ts:1005

Whether the wallet needs recovery (signer registration) before the next transaction.

Returns

boolean

true if recovery is needed

Inherited from

Wallet.needsRecovery

---

nfts()

nfts(params): Promise<unknown>

Defined in: packages/wallets/src/wallets/wallet.ts:394

Get the wallet NFTs

Parameters

Parameter	Type	Description
params	{ page: number; perPage: number; }	The parameters
params.page	number	The page number
params.perPage	number	The number of NFTs per page

Returns

Promise<unknown>

The NFTs

Inherited from

Wallet.nfts

---

recover()

recover(): Promise<void>

Defined in: packages/wallets/src/wallets/wallet.ts:1021

Register a device signer with the wallet using the recovery signer. Generates a new device key and registers it on-chain. Returns early if the device signer’s locator is already approved on-chain.

Returns

Promise<void>

Inherited from

Wallet.recover

---

removeSigner()

removeSigner<T>(signer, options?): Promise<RemoveSignerReturnType>

Defined in: packages/wallets/src/wallets/wallet.ts:783

Remove a signer from the wallet. Always uses the recovery signer internally to approve the removal.

Type Parameters

Type Parameter	Default type
T extends RemoveSignerOptions | undefined	undefined

Parameters

Parameter	Type	Description
signer	ExternalWalletRegistrationConfig | EmailSignerConfig | PhoneSignerConfig | DeviceSignerConfig | BaseSignerConfig<"solana">	The signer to remove, provided as a signer config object
options?	T	The options for the operation

Returns

Promise<RemoveSignerReturnType>

Inherited from

Wallet.removeSigner

---

send()

send<T>(to, token, amount, options?): Promise<Transaction<T extends PrepareOnly<true> ? true : false>>

Defined in: packages/wallets/src/wallets/wallet.ts:469

Send a token to a wallet or user locator

Type Parameters

Type Parameter	Default type
T extends SendTokenTransactionOptions | undefined	undefined

Parameters

Parameter	Type	Description
to	string | UserLocator	The recipient (address or user locator)
token	string	The token (address or currency symbol)
amount	string	The amount to send (decimal units)
options?	T	The options for the transaction

Returns

Promise<Transaction<T extends PrepareOnly<true> ? true : false>>

The transaction

Inherited from

Wallet.send

---

sendTransaction()

sendTransaction<T>(params): Promise<Transaction<T extends PrepareOnly<true> ? true : false>>

Defined in: packages/wallets/src/wallets/solana.ts:56

Send a raw Solana transaction.

Type Parameters

Type Parameter	Default type
T extends TransactionInputOptions | undefined	undefined

Parameters

Parameter	Type	Description
params	SolanaTransactionInput & object	The transaction parameters (serialized transaction or Transaction object)

Returns

Promise<Transaction<T extends PrepareOnly<true> ? true : false>>

The transaction result

---

signerIsRegistered()

signerIsRegistered(signerLocator): Promise<boolean>

Defined in: packages/wallets/src/wallets/wallet.ts:987

Check if a signer is registered in this wallet.

Parameters

Parameter	Type	Description
signerLocator	string	The locator of the signer to check

Returns

Promise<boolean>

true if the signer is registered

Inherited from

Wallet.signerIsRegistered

---

signers()

signers(): Promise<Signer[]>

Defined in: packages/wallets/src/wallets/wallet.ts:1038

List the signers for this wallet. Returns full signer objects with status. For EVM wallets, only signers with an approval (pending or completed) for the wallet’s chain are included.

Returns

Promise<Signer[]>

The signers

Inherited from

Wallet.signers

---

stagingFund()

stagingFund(amount, chain?): Promise<FundWalletResponse>

Defined in: packages/wallets/src/wallets/wallet.ts:364

Funds the wallet with Crossmint’s stablecoin (USDXM).

Note: This method is only available in staging environments and exclusively supports USDXM tokens. It cannot be used in production environments.

Parameters

Parameter	Type	Description
amount	number	The amount of USDXM to fund the wallet with
chain?	Chain	Optional chain to fund on. If not provided, uses the wallet’s default chain

Returns

Promise<FundWalletResponse>

The funding response

Throws

If the funding operation fails or if called in a production environment

Inherited from

Wallet.stagingFund

---

transaction()

transaction(transactionId): Promise<WalletsTransactionV2025ResponseDtoClass>

Defined in: packages/wallets/src/wallets/wallet.ts:426

Get a transaction by id

Parameters

Parameter	Type
transactionId	string

Returns

Promise<WalletsTransactionV2025ResponseDtoClass>

The transaction

Throws

If the transaction cannot be retrieved

Inherited from

Wallet.transaction

---

transactions()

transactions(): Promise<GetTransactionsResponse>

Defined in: packages/wallets/src/wallets/wallet.ts:413

Get the wallet transactions

Returns

Promise<GetTransactionsResponse>

The transactions

Throws

If the transactions cannot be retrieved

Inherited from

Wallet.transactions

---

transfers()

transfers(params): Promise<WalletsActivityResponseUnstableDto>

Defined in: packages/wallets/src/wallets/wallet.ts:441

Get the wallet transfers

Parameters

Parameter	Type
params	{ status: "successful" | "failed"; tokens: string; }
params.status	"successful" | "failed"
params.tokens?	string

Returns

Promise<WalletsActivityResponseUnstableDto>

The transfers

Throws

If the transfers cannot be retrieved

Inherited from

Wallet.transfers

---

useSigner()

useSigner(signer): Promise<void>

Defined in: packages/wallets/src/wallets/wallet.ts:841

Set the active signer for this wallet. Accepts a signer config object. The locator is inferred internally. Works for both registered signers and the recovery signer.

For passkey signers: if no id is provided, the wallet will auto-select the passkey if exactly one passkey signer is registered. If multiple passkeys exist, an id must be specified.

For device signers: if no device key is found locally, the signer will be created automatically during the next transaction (via recovery).

For external-wallet signers: the config object must include an onSign callback (applies to both registered and recovery signers).

Parameters

Parameter	Type	Description
signer	EmailSignerConfig | PhoneSignerConfig | DeviceSignerConfig | BaseSignerConfig<"solana">	The signer config object to use

Returns

Promise<void>

Inherited from

Wallet.useSigner

---

waitForInit()

waitForInit(): Promise<void>

Defined in: packages/wallets/src/wallets/wallet.ts:186

Wait for the wallet’s internal signer initialization to complete. After this resolves, needsRecovery() reflects the true state.

Returns

Promise<void>

Inherited from

Wallet.waitForInit

---

from()

static from(wallet): SolanaWallet

Defined in: packages/wallets/src/wallets/solana.ts:36

Parameters

Parameter	Type
wallet	Wallet<Chain>

Returns

SolanaWallet