Fetch Durable Nonce Accounts

Designing

Development

https://vf-solana-api.dev.alphaledger.com

POST

/api/v1/durable-nonce-accounts/bulk

Creates Solana Transaction:No

OperationId:fetchDurableNonceAccounts

Fetches available nonce accounts that have been setup.

Allowed values in the fieldName for sortModel and filterModel:

fieldName	dataType	description	sort
nonceAuthorityOnchainId	ADDRESS_ONCHAIN_ID	The onchainId for the Nonce Authority associated with the Nonce Account
nonceAuthorityOffchainId	OFFCHAIN_ID	The offchainId for the Nonce Authority associated with the Nonce Account
nonceAccountOnchainId	ADDRESS_ONCHAIN_ID	The onchainId for the Nonce Account
nonceAccountOffchainId	OFFCHAIN_ID	The offchainId for the Nonce Account
nonceAccountCode	TEXT	The Offchain References Code for the Nonce Account
isInUse	BOOLEAN	Identifies if the Nonce Account is currently in use by an in-flight transaction	(ASC)^*
inUseByTransactionId	OFFCHAIN_ID	The offchainId transaction that is currently uses the nonce account
nonceHash	TEXT	The current hash value of the Nonce Account

(ASC|DESC)^* - columns that are part of the default sort if no itemQuery.sortModel is provided.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/durable-nonce-accounts/bulk?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemsQuery": {
        "limit": 10,
        "skip": 0,
        "filter": [
            {
                "fieldName": "See the endpoint description for allowed values",
                "operator": "AND",
                "filterValues": [
                    {
                        "dataType": "TEXT",
                        "filterType": "EQUALS",
                        "valueString": "string",
                        "valueNumber": 0,
                        "valueBoolean": true,
                        "valuesString": [
                            "string"
                        ],
                        "valueFromString": "string",
                        "valueToString": "string",
                        "valueFromNumber": 0,
                        "valueToNumber": 0
                    }
                ]
            }
        ],
        "sort": [
            {
                "fieldName": "See the endpoint description for allowed values",
                "sortDirection": "ASC"
            }
        ]
    },
    "outputConfig": {
        "excludePrivateKeyDetails": true
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'

Response Example

200 - Example 1

{
    "count": 5,
    "items": [
        {
            "nonceAccount": {
                "onchain": {
                    "id": "6YaAdbMCV5GPRZ6AYbyEnGgggAHfEJjXTXYGrDVasQHK",
                    "lastTransactionId": "5vnjT6E19V4uQwHMojaR73XFoPjt9Y2nFn74xdDJZTK1MYScNWHpf876JFnSVzSqLxzEMLyzH355WWoiFN5ceMa9",
                    "lastTransactionAt": "2024-11-19T14:30:00.000Z",
                    "creationTransactionId": "3mTmwiMhwK286USNGGxCormm3srWcR5qmbCUb96jbz79Td53r6Nk2krCPeJ4LUUunwER8icNfGFXD2SQ8RnFPiZL",
                    "creationTransactionAt": "2024-11-19T14:30:00.000Z"
                },
                "offchain": {
                    "id": "b3e30f57-b404-4bd5-9e31-cec3298fa0bf",
                    "type": "WALLET",
                    "code": "BCDA",
                    "alId": "ALFNDPF000153786",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT355566",
                    "name": "Trading Account",
                    "lamportsBalance": 4540000,
                    "tokenBalance": 2500000000,
                    "tokenDecimals": 8,
                    "lastTransactionId": "63e1c252-a23c-42af-a7f2-f48a2893c940",
                    "creationTransactionId": "f785791f-826b-4fe0-9547-6475518cdc7f",
                    "solDebitApiKeys": [
                        "string"
                    ],
                    "tokenDebitApiKeys": [
                        "string"
                    ]
                },
                "managed": true,
                "privateKeyLocation": [
                    "SECRETS"
                ],
                "isDerived": true,
                "comments": "Some comments attached to the account",
                "subscribeToNetworkEvents": true,
                "sharedAcrossTenants": true,
                "wasOnchainAlready": true,
                "canPayFees": true,
                "globalFeePayerForOrgs": [
                    "string"
                ],
                "domain": "string"
            },
            "nonceAuthority": {
                "onchain": {
                    "id": "string"
                },
                "offchain": {
                    "id": "string"
                },
                "managed": true
            },
            "nonceHash": "AgrkCPVG2Tuo7Se1vPDXM53XExTbr8esHChk1bJC9Bv5",
            "inUse": {
                "transactionOffchainId": "string",
                "transactionAt": "string"
            }
        }
    ]
}

Modified at 2025-11-24 12:02:15

Fetch Durable Nonce Account Details

Address Lookup Tables