Create Durable Nonce Accounts

Developing

Development

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

POST

/api/v1/durable-nonce-accounts

Creates one or moe durable nonce account to be added to the pool of durable nonce accounts that can be used for processing transactions with a messageLifetimeStrategy of DURABLE_NONCE. Go to Transaction Processing for additional details.

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

🟢201Created

application/json

Body

🟠400

🟠401

🟠403

🟠409

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/durable-nonce-accounts?svmCluster=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemData": {
        "nonceAccount": {
            "managed": true,
            "alreadyOnchain": false,
            "onchainId": "5ppHUtrk8vZjRdhwsYXJEPKwEPjazsMDyfBvJbhjmyah",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET",
                "name": "Additional info related to the offchain reference"
            },
            "privateKeyDetails": {
                "location": [
                    "DATABASE"
                ],
                "publickKey": "5ppHUtrk8vZjRdhwsYXJEPKwEPjazsMDyfBvJbhjmyah",
                "privateKey": "EB46eeJToBz34ifceU1sYXWeferhcvaS28RsmQe9khX2Sv87wEnGgYbYC6deyhYSFVusxFvjKud2VTu6p2aCG9A",
                "dkgKeys": [
                    {
                        "keyUsage": "INV_TRADING_FX",
                        "useBackendPlayersCodes": [
                            "alt",
                            "alt"
                        ],
                        "isDefault": false,
                        "session": {
                            "threshold": 2
                        }
                    }
                ]
            },
            "networkCurrencyDebitApiKeys": [
                "abcd"
            ],
            "tokenDebitApiKeys": [
                "string"
            ],
            "networkCurrencyDebitLimits": [
                {
                    "destination": "ANY",
                    "maxAllowedDebit": {
                        "limitType": "PER_TRANSACTION",
                        "limitAmount": 100,
                        "duration": {
                            "code": "DAYS",
                            "unit": 1
                        },
                        "approversForOverride": [
                            "string"
                        ],
                        "requiredApproversCount": 3
                    }
                }
            ],
            "tokenDebitLimits": [
                {
                    "operationType": "ANY",
                    "destination": "ANY",
                    "mintAuthority": "ANY",
                    "maxAllowedDebit": {
                        "limitType": "PER_TRANSACTION",
                        "limitAmount": 100,
                        "duration": {
                            "code": "DAYS",
                            "unit": 1
                        },
                        "approversForOverride": [
                            "string"
                        ],
                        "requiredApproversCount": 3
                    }
                }
            ],
            "dataLength": 0,
            "seed": {
                "amount": 3.8097,
                "lamports": 8733302
            },
            "subscribeToNetworkEvents": true,
            "canPayFees": false,
            "globalFeePayerForOrgs": [
                "ALT"
            ],
            "orgsAllowedToSignWithPrivateKey": [
                "ALT"
            ],
            "shareAcrossTenants": false,
            "tokenVersion": "SPL",
            "comments": "Additional information about this account",
            "isDerived": false,
            "isGenesis": false,
            "domain": "vulcan-forge.sol",
            "skipBlockchainExistenceVerification": false,
            "missingSignatureWebhooks": [
                {
                    "endpointUrl": "stringstri",
                    "name": "string",
                    "apiKeyAuthConfig": {
                        "httpHeaderName": "string",
                        "keyValue": "string"
                    },
                    "oauth2AuthConfig": {
                        "accessTokenUrl": "stringstri",
                        "audience": "string",
                        "flowType": "CLIENT_CREDENTIALS",
                        "clientId": "string",
                        "clientSecret": "string",
                        "userName": "string",
                        "password": "string"
                    },
                    "timeout": 1
                }
            ],
            "preTransactionSubmitWebhooks": [
                {
                    "endpointUrl": "stringstri",
                    "name": "string",
                    "apiKeyAuthConfig": {
                        "httpHeaderName": "string",
                        "keyValue": "string"
                    },
                    "oauth2AuthConfig": {
                        "accessTokenUrl": "stringstri",
                        "audience": "string",
                        "flowType": "CLIENT_CREDENTIALS",
                        "clientId": "string",
                        "clientSecret": "string",
                        "userName": "string",
                        "password": "string"
                    },
                    "timeout": 1,
                    "doNotSubmitTransactionOnFailure": false
                }
            ],
            "postTransactionSubmitWebhooks": [
                {
                    "endpointUrl": "stringstri",
                    "name": "string",
                    "apiKeyAuthConfig": {
                        "httpHeaderName": "string",
                        "keyValue": "string"
                    },
                    "oauth2AuthConfig": {
                        "accessTokenUrl": "stringstri",
                        "audience": "string",
                        "flowType": "CLIENT_CREDENTIALS",
                        "clientId": "string",
                        "clientSecret": "string",
                        "userName": "string",
                        "password": "string"
                    },
                    "timeout": 1
                }
            ]
        },
        "numberOfNonceAccounts": 1,
        "nonceAuthority": {
            "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
            "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "autoSign": true,
            "otherTenantOrganizationExternalId": "ALIM",
            "offPlatform": false
        }
    },
    "svmTransactionConfig": {
        "feePayer": {
            "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
            "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "autoSign": true,
            "otherTenantOrganizationExternalId": "ALIM",
            "offPlatform": false
        },
        "computeUnitConfig": {
            "enable": true,
            "limit": 0,
            "price": 0,
            "priceEstimate": {
                "provider": "HELIUS",
                "calculationStrategy": "DEFAULT",
                "priorityLevel": "RECOMMENDED"
            }
        },
        "commitmentConfig": {
            "commitmentLevel": "processed"
        },
        "messageLifetimeStrategy": "RECENT_BLOCKHASH",
        "transactionVersion": "V0"
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'

Response Example

201 - Example 1

{}

Modified at 2026-04-04 10:26:46

Durable Nonces

Fetch Durable Nonce Account Details