A funder is a wallet Proxima holds for your account and uses as the source of funding jobs. Each funder has a network type: an SVM funder serves Solana, an EVM funder serves every EVM chain and reports a native balance per chain.
A funder can be the default for one or more chains. When the web app creates a funding draft, it picks the default funder of the target chain. Withdrawing to one of your own funders never prompts for 2FA (see Withdrawals).
The Funder object
A funder wallet of the account with its live native balances.
Attributes
-
pubkeystringFunder address. EVM addresses are lowercase. -
network_typeenumNetwork type. An EVM funder serves every EVM chain.Possible valuessvmevm -
is_defaultarray<string>Chain IDs this funder is the default for. Empty when it is the default nowhere. -
native_balancesobjectNative balance per chain ID, in base units (lamports or wei), as decimal strings. -
created_atintegerUnix timestamp (seconds) at which the funder was created.
List funders
/wallets/funders/list Returns every funder of the account, SVM and EVM, with live native balances.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Parameters
No parameters.
Returns 200 OK · application/json
Returns a list of Funder objects.
-
fundersarray<object>Funders of the account.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | Reading the balances of SVM funders from the RPC failed. Retry after a short wait. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.wallets.funders.list() src/lib/proxima/endpoints/wallets/funders.ts
Create a funder
/wallets/{network_type}/funders/add Generates a new funder, imports one from a private key, or promotes an existing wallet to funder.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Generating creates a new funder on each call; importing the same secret again is harmless. Before retrying a generate, call List funders and check whether the funder was added.
The web app generates new funders and, on SVM, promotes an existing wallet by address from the funder settings.
Path parameters
-
network_typeenum RequiredNetwork type of the funder.Possible valuessvmevm
Body parameters application/json
-
keystring | object RequiredThe string"None"to generate a new keypair,{ "secret": "..." }to import a private key, or{ "pubkey": "..." }to use one of your existing wallets (SVM only).Child attributes 2
-
secretstring OptionalPrivate key to import. Requires key-management rights on the license. -
pubkeystring OptionalAddress of an existing wallet of the account to use as funder. SVM only.
-
-
is_defaultboolean OptionalWhether to make the new funder the default.
Returns 200 OK · application/json
-
pubkeystringAddress of the funder.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | network_type is not svm or evm. Use svm or evm as network_type. |
| 400 | bad_request | key.secret is not a valid secret key for the network. Send a valid secret key for the network in key.secret. |
| 400 | bad_request | On SVM, key.pubkey is not a valid Solana address. Send a valid base58 address in key.pubkey. |
| 400 | bad_request | key.pubkey was sent on EVM, where a funder can only be generated or imported. Generate the EVM funder, or import it with key.secret. |
| 403 | forbidden | A secret key was sent and the license cannot import keys. Generate the funder instead, or use a license with key-management rights. |
| 404 | not_found | On SVM, the wallet named by key.pubkey is not on the account. Use an address from List wallets. |
| 422 | unprocessable | The account already has 10 funders on this network. Remove an unused funder with Delete a funder first. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.funders.add(networkType, request) src/lib/proxima/endpoints/wallets/funders.ts
Export a funder key
/wallets/funders/export Returns the private key of a funder.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Two-factor
- Step-up for
wallet.export_funderwhen the user protects it. How it works - Retry
- Safe to retry Read-only: a repeat returns the same key.
Body parameters application/json
-
pubkeystring RequiredAddress of the funder.
Returns 200 OK · application/json
-
pubkeystringAddress of the funder. -
secret_keystringPrivate key: base58 on SVM, hex on EVM.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 404 | not_found | On EVM, the funder is not on the account. Use an address from List funders. |
| 500 | internal_error | On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from List funders. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token, 401 2fa_required and 429 when rate limited.
Web client proxima.wallets.funders.export(pubkey) src/lib/proxima/endpoints/wallets/funders.ts
Delete a funder
/wallets/funders/remove Removes a funder that holds no withdrawable balance.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry A repeat after a successful removal returns a "Funder not found" error.
Before deleting, the web app withdraws the funder's balance and waits for the withdrawal to finish.
Body parameters application/json
-
pubkeystring RequiredAddress of the funder.
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | On SVM, the address is not a valid Solana address. Use an address from List funders. |
| 404 | not_found | On EVM, the funder is not on the account. Use an address from List funders. |
| 500 | internal_error | On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from List funders. |
| 409 | conflict | On EVM, the funder still holds a withdrawable balance on a chain. Move the balance out with Execute a withdrawal, then retry. |
| 409 | conflict | On SVM, the funder still holds a withdrawable balance. Move the balance out with Execute a withdrawal, then retry. |
| 500 | internal_error | On SVM, the funder is the account's last funder. Returned as a 500. EVM has no such check. Create another funder with Create a funder first. |
| 500 | internal_error | On SVM, the funder is the account's active shield deployer. Returned as a 500. Keep this funder while the shield it deployed is active. |
| 422 | upstream_failure | On SVM, the balance check could not read the funder's balance from the RPC. Retry after a short wait. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.funders.remove(pubkey) src/lib/proxima/endpoints/wallets/funders.ts
Set the default funder
/wallets/funders/set-default Makes a funder the default for the given chains.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Chains are applied one at a time, so after an error the earlier chains may already be set; check List funders. Sending the same body again is harmless.
Body parameters application/json
-
pubkeystring RequiredAddress of the funder. -
chainsarray<string> RequiredChain IDs to make it the default for. Must match the funder's network type.
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | An EVM funder was set for sol. Use an SVM funder for sol. |
| 400 | bad_request | An SVM funder was set for an EVM chain. Use an EVM funder for EVM chains. |
| 404 | not_found | On EVM, the funder is not on the account. Use an address from List funders. |
| 500 | internal_error | On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from List funders. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.funders.setDefault(pubkey, chains) src/lib/proxima/endpoints/wallets/funders.ts