Create Address Lookup Table

Developing

Development

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

POST

/api/v1/address-lookup-tables

Creates Solana Transaction:If Requested

OperationId:createAddressLookupTable

Creates an Address Lookup Table. Please note that once component addresses are added to an address lookup table, they cannot be removed from it.

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/jsonRequired

Examples

Responses

🟢201Created

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/address-lookup-tables?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemData": {
        "addressLookupTable": {
            "managed": true,
            "alreadyOnchain": false,
            "onchainId": "5ppHUtrk8vZjRdhwsYXJEPKwEPjazsMDyfBvJbhjmyah",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "privateKeyDetails": {
                "location": [
                    "DATABASE"
                ],
                "publickKey": "5ppHUtrk8vZjRdhwsYXJEPKwEPjazsMDyfBvJbhjmyah",
                "privateKey": "EB46eeJToBz34ifceU1sYXWeferhcvaS28RsmQe9khX2Sv87wEnGgYbYC6deyhYSFVusxFvjKud2VTu6p2aCG9A",
                "dkgKeys": [
                    {
                        "keyUsage": "INV_TRADING_FX",
                        "useBackendPlayersCodes": [
                            "alt",
                            "alt"
                        ],
                        "isDefault": false,
                        "session": {
                            "threshold": 2
                        }
                    }
                ]
            },
            "solDebitApiKeys": [
                "abcd"
            ],
            "tokenDebitApiKeys": [
                "string"
            ],
            "dataLength": 0,
            "seedSol": 0.087,
            "subscribeToNetworkEvents": true,
            "canPayFees": false,
            "globalFeePayerForOrgs": [
                "ALT"
            ],
            "shareAcrossTenants": false,
            "tokenVersion": "SPL",
            "comments": "Additional information about this account",
            "isDerived": false,
            "isGenesis": false,
            "domain": "vulcan-forge.sol"
        },
        "authority": {
            "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
            "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "isOtherTenantSigner": false,
            "otherTenantOrganizationExternalId": "ALIM",
            "offPlatform": false
        },
        "componentAddresses": [
            {
                "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                "offchainReferences": {
                    "alId": "ALFNDPF000153778",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT10000233",
                    "code": "some-authority",
                    "type": "WALLET"
                },
                "isOtherTenantSigner": false,
                "otherTenantOrganizationExternalId": "ALIM",
                "offPlatform": false
            }
        ]
    },
    "solanaTransactionConfig": {
        "feePayer": {
            "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
            "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "isOtherTenantSigner": false,
            "otherTenantOrganizationExternalId": "ALIM",
            "offPlatform": false
        },
        "computeUnitConfig": {
            "enable": true,
            "limit": 1400000,
            "price": 35000,
            "priceEstimate": {
                "provider": "HELIUS",
                "calculationStrategy": "DEFAULT"
            }
        },
        "commitmentConfig": {
            "commitmentLevel": "processed"
        },
        "messageLifetimeStrategy": "RECENT_BLOCKHASH",
        "transactionVersion": "V0"
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'

Response Example

201 - Example 1

{
    "newAddressLookupTable": {
        "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"
    }
}

Modified at 2025-11-24 10:28:40

Address Lookup Tables

Fetch Address Lookup Table Details