> For AI agents: the documentation index is at https://sdk.nimbusprivacy.xyz/llms.txt, and every page is available as Markdown at its URL with .md appended.

# API reference (/reference)

This section documents everything `@umbra/nimbus-solana-web` exports. Each function has one entry,
with its signature, an example, its parameters and what it returns. Each entry is generated from the
SDK's declarations and TSDoc when this site is built, so it matches the package.

The guides show how the functions fit together. This section is where you look one up. Every
mention of an export elsewhere on the site links to its entry here.

## Functions

| Export                                                                                                                          | What it does                                                               |
| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| [`loadNimbusSdk`](https://sdk.nimbusprivacy.xyz/reference/load#loadnimbussdk)                                                   | Loads the SDK for a cluster. Every other call starts from what it returns. |
| [`listWallets`](https://sdk.nimbusprivacy.xyz/reference/wallets#listwallets)                                                    | Lists the installed wallets that can sign on the cluster.                  |
| [`followWallets`](https://sdk.nimbusprivacy.xyz/reference/wallets#followwallets)                                                | Calls you with the new list each time a wallet registers or unregisters.   |
| [`openWalletConnection`](https://sdk.nimbusprivacy.xyz/reference/wallets#openwalletconnection)                                  | Connects a wallet and returns the signer a session takes.                  |
| [`openNimbusSession`](https://sdk.nimbusprivacy.xyz/reference/sessions#opennimbussession)                                       | Opens the user's private account on this device.                           |
| [`closeNimbusSession`](https://sdk.nimbusprivacy.xyz/reference/sessions#closenimbussession)                                     | Clears a session's keys and gateway token from memory.                     |
| [`createMemorySignatureSecretStore`](https://sdk.nimbusprivacy.xyz/reference/sessions#creatememorysignaturesecretstore)         | Keeps the unlock signature in the page's memory only.                      |
| [`createTabSignatureSecretStore`](https://sdk.nimbusprivacy.xyz/reference/sessions#createtabsignaturesecretstore)               | Keeps the unlock signature for the tab. This is the default.               |
| [`createPersistentSignatureSecretStore`](https://sdk.nimbusprivacy.xyz/reference/sessions#createpersistentsignaturesecretstore) | Keeps the unlock signature in the browser until it is wiped.               |
| [`readRegistration`](https://sdk.nimbusprivacy.xyz/reference/registration#readregistration)                                     | Reads whether the user is registered now.                                  |
| [`createRegistrationContext`](https://sdk.nimbusprivacy.xyz/reference/registration#createregistrationcontext)                   | Creates the context a registration runs in.                                |
| [`register`](https://sdk.nimbusprivacy.xyz/reference/registration#register)                                                     | Registers the user, once, before their first deposit.                      |
| [`createDepositContext`](https://sdk.nimbusprivacy.xyz/reference/deposit#createdepositcontext)                                  | Creates the context a deposit runs in.                                     |
| [`deposit`](https://sdk.nimbusprivacy.xyz/reference/deposit#deposit)                                                            | Moves tokens from the wallet into a private balance.                       |
| [`resolvePendingDeposit`](https://sdk.nimbusprivacy.xyz/reference/deposit#resolvependingdeposit)                                | Learns how a deposit whose outcome was unknown ended.                      |
| [`refundStrandedDeposit`](https://sdk.nimbusprivacy.xyz/reference/deposit#refundstrandeddeposit)                                | Returns funds a version 0 deposit left halfway.                            |
| [`createTransferContext`](https://sdk.nimbusprivacy.xyz/reference/transfer#createtransfercontext)                               | Creates the context a Private Send runs in.                                |
| [`transfer`](https://sdk.nimbusprivacy.xyz/reference/transfer#transfer)                                                         | Pays another user from the private balance.                                |
| [`createWithdrawalContext`](https://sdk.nimbusprivacy.xyz/reference/withdraw#createwithdrawalcontext)                           | Creates the context a withdrawal runs in.                                  |
| [`withdraw`](https://sdk.nimbusprivacy.xyz/reference/withdraw#withdraw)                                                         | Moves tokens out of the private balance to any address.                    |
| [`readBalances`](https://sdk.nimbusprivacy.xyz/reference/reads#readbalances)                                                    | Reads the private balance from the device.                                 |
| [`readHistory`](https://sdk.nimbusprivacy.xyz/reference/reads#readhistory)                                                      | Reads past payments, one page at a time.                                   |
| [`syncNoteStore`](https://sdk.nimbusprivacy.xyz/reference/reads#syncnotestore)                                                  | Brings the device up to date with Solana.                                  |
| [`listReservedSpends`](https://sdk.nimbusprivacy.xyz/reference/reserved-funds#listreservedspends)                               | Lists the payments that hold part of the balance.                          |
| [`releaseReservedNotes`](https://sdk.nimbusprivacy.xyz/reference/reserved-funds#releasereservednotes)                           | Gives back what stopped payments hold.                                     |
| [`findMintByIdentifier`](https://sdk.nimbusprivacy.xyz/reference/tokens#findmintbyidentifier)                                   | Names the token of a history item.                                         |
| [`NimbusSdkError`](https://sdk.nimbusprivacy.xyz/reference/errors#nimbussdkerror)                                               | The error the SDK throws when it cannot go on.                             |
| [`isNimbusSdkError`](https://sdk.nimbusprivacy.xyz/reference/errors#isnimbussdkerror)                                           | Recognises a `NimbusSdkError`.                                             |
| [`isNimbusSolanaFlowError`](https://sdk.nimbusprivacy.xyz/reference/errors#isnimbussolanaflowerror)                             | Recognises the protocol's refusals.                                        |
| [`proveWorkerRequest`](https://sdk.nimbusprivacy.xyz/reference/prover-worker#proveworkerrequest)                                | Answers a proof request inside a prover worker of your own.                |
| [`copy-assets`](https://sdk.nimbusprivacy.xyz/reference/prover-worker#copy-assets)                                              | The command that copies the SDK's browser files into your app.             |

## Types

[Types](https://sdk.nimbusprivacy.xyz/reference/types) lists every exported type in alphabetical order. Here they are grouped by
what they describe.

| Group                      | Types                                                                                                                                                                                                                                                                                                                                              |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Loading and settings       | `LoadNimbusSdkOptions`, `NimbusSdk`, `NimbusCluster`, `NimbusRoute`, `NimbusRoutingDefaults`, `NimbusSettings`, `NimbusEndpoints`, `NimbusGatewayEndpoint`, `NimbusNodeEndpoint`, `NimbusGatewayToken`, `NimbusMint`, `NimbusPlatform`, `NimbusBrowserPlatform`, `NimbusProving`, `NimbusProvingKeys`, `NimbusProvingKeyStatement`, `NimbusTiming` |
| Wallets                    | `ConnectedWallet`, `WalletConnectionResult`, `WalletDiscoveryOptions`, `WalletStandardAccount`, `WalletStandardSigner`                                                                                                                                                                                                                             |
| Sessions                   | `NimbusSession`, `OpenNimbusSessionOptions`, `OpenNimbusSessionResult`, `NimbusRegistrationStanding`, `SignatureSecretKey`, `SignatureSecretReading`, `SignatureSecretStore`, `SignatureSecretStoreOptions`                                                                                                                                        |
| Contexts                   | `RegistrationContext`, `DepositContext`, `TransferContext`, `WithdrawalContext`, `RegistrationContextOptions`, `NimbusContextOptions`, `NimbusFlowRouting`, `NimbusZone`                                                                                                                                                                           |
| Options                    | `RegisterOptions`, `DepositOptions`, `TransferOptions`, `WithdrawOptions`, `SpendOptions`, `SentTransactionOptions`, `SyncFirstOptions`, `StrandedDepositRefundOptions`, `TransactionVersion`, `ConfirmationCommitment`                                                                                                                            |
| Results                    | `RegistrationResult`, `DepositResult`, `TransferResult`, `WithdrawalResult`, `PendingDepositResolutionResult`, `StrandedDepositRefundResult`, `DepositSubmission`, `TransactionSubmission`, `SettledSpendOutcome`, `SpendSettlement`                                                                                                               |
| Progress                   | `RegisterStage`, `DepositStage`, `TransferStage`, `WithdrawStage`, `RefundStage`, `SyncedStage`, `SettledStage`                                                                                                                                                                                                                                    |
| Refusals                   | `SpendRefusal`, `WalletStoreRefusal`, `BeginAttemptRefusal`, `LeaseRefusal`, `MarkAttemptSentRefusal`, `MergeFailureCause`                                                                                                                                                                                                                         |
| Errors                     | `NimbusSdkErrorReason`, `NimbusSolanaFlowError`, `NimbusSolanaFlowErrorReason`                                                                                                                                                                                                                                                                     |
| Balances, history and sync | `Balance`, `HistoryPage`, `HistoryPosition`, `NoteStoreSyncResult`, `NoteStoreSyncRound`, `SyncNoteStoreOptions`                                                                                                                                                                                                                                   |
| Reserved funds             | `ReservedSpend`, `ReservedSpendState`, `ReleasedNotes`                                                                                                                                                                                                                                                                                             |
| Prover worker              | `ProverWorkerRequest`, `ProverWorkerAnswer`, `ProverWorkerDeps`, `WitnessGraphHandle`                                                                                                                                                                                                                                                              |

The SDK also exports `Wallet`, the Wallet Standard's own type.

## Next

- [The function template](https://sdk.nimbusprivacy.xyz/api-design/function-template): How every function is shaped.
- [Results and errors](https://sdk.nimbusprivacy.xyz/api-design/results-and-errors): Every result kind and error reason.
- [Types](https://sdk.nimbusprivacy.xyz/reference/types): Every exported type, in alphabetical order.


Last updated 21 October 2026
