Vulcan Forge by Alphaledger

Creates/onboards a Solana Account on the Vulcan Forge system and onchain (optional). Use the itemData.alreadyOnchain=true setting to only onboard the account into Vulcan Forge but not submit a Solana transaction to create the account on the network (because the account would already be on the network).

The itemData.managed indicates if Vulcan Forge has access to the account's private key or not.

IMPORTANT NOTE: if the dataLength is specified for the account, space will be reserved on the blockchain based on this parameter. Also for all accounts owned by the System Program, any SOL seeded into the account cannot be transferred out if dataLength > 0.

See the the offchainReferences.type field for the different types of accounts supported on Vulcan Forge. Note that for the following types more specialized endpoints can/need to be used to create the accounts:

Account Type	Enpoint to Use
FUNDS_TOKEN_ACCOUNT and ASSET_TOKEN_ACCOUNT	Initialize Position
FUNDS_TOKEN or ASSET_TOKEN	Optional - the mint account for a token can be created with the Create Financial Instrument endpoint directly or it can be created with the Create Account endpoint
ADDRESS_LOOKUP_TABLE	Create Address Lookup Table
NONCE	Create Durable Nonce Accounts

The VULCAN_FORGE_UPDATE_DEBIT_API_KEYS role is required to allow the API Key to change the solDebitApiKeys or tokenDebitApiKeys fields.

Default Debit Limits:

Unless overriden through configurations on the debitLimits field, the defaults reflected in the tables below apply. If for e.g. a limit config is put in place only for SOL outgoing transfers, the default values for debit operations on TOKENs still apply - and vice versa. The same applies if a limit is entered for type PER_OPERATION but a DURATION Limit is not specified. The DURATION limit check will be done based on the default value.

These defaults are put in place to reduce the chances of accidental debit operations and to increase the chances of having some escape routes to clawback funds/tokens sent to unwanted destinations when accidents do happen. Use caution when increasing these limits and be as specific as possible regarding the scope that they should apply to - e.g. don't increase the limits on Burn operations too if you want to only increase the limits for outgoing transfers of tokens.

NETWORK CURRENCY (SOL) OUTGOING TRANSFERS

Destination	Limit Type	Max allowed amount w/o approval
OFF_PLATFORM	PER_OPERATION	0
OFF_PLATFORM	DURATION (last 24hrs)	0
NON_MANAGED	PER_OPERATION	1
NON_MANAGED	DURATION (last 24hrs)	Unlimited
MANAGED	PER_OPERATION	Unlimited
MANAGED	DURATION (last 24hrs)	Unlimited

TOKENS

Applicable only to Blockchain Account Types of: WALLET, ASSETS_WALLET, CURRENCIES_WALLET, DEFI_SETTLEMENT_WALLET

See the Initialize Position Endpoint for details on the debitLimits defaults at the token level

Destination Types for Outgoing Network Currency (SOL) Transfers:

OFF_PLATFORM - Not onboarded on the Vulcan Forge platform

NON_MANAGED - Onboarded on the platform, but private key not hosted on it

MANAGED - Onboarded on the platform and private key hosted on it

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/accounts?solanaClusterId=SOLANA_DEVNET' \ --header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '// Managed - Not yet onchain (Token Management Authority) { "itemData": { "managed": true, "alreadyOnchain": false, "comments": "Account which should be used as Update Authority with a Token 2022 Token", "privateKeyDetails": { "location": [ "DATABASE" ] }, "offchainReferences": { "code": "update-db", "type": "TOKEN_MANAGEMENT_AUTHORITY", "organizationExternalId": "ALIM" } } }'

{ "newAccount": { "onchainId": "ndA7eTfoWqrczXYUq53gNRRjQgEmufqErXbgXUFFUAA", "offchainId": "1a1e904d-0d95-4e66-85e1-88a57774e910" }, "solanaTransaction": { "success": false, "offchainId": "ee36c656-aa74-4d6a-b23c-332c204cb202", "status": "SIGNED", "onchainId": "5nwo7XvhiVRpJasEzH5r3hGKJqaTxd7qVit3cedFJgESdAPrmawebMJu6fUKRfjXEaivuey7vBsW56xPxX76T1bm", "confirmationsCount": 2, "serializedMessage": "string", "errorMessage": "string", "txnTimestamp": "2025-10-21T16:17:45.035372Z" } }

Create Account

Request

Responses