Skip to main content
Generated by pnpm solana:api from deployed platform source 709d50e15dc1854196210ce93ada0b6ce4b88c8f, src/solana/routes.ts. Response names refer to published SDK 0.9.0-solana-preview.1 declarations. Solana routes are separate from the unchanged Base OpenAPI reference. They are not a stable OpenAPI contract.
Base URL: https://api.gol.network. All routes require Authorization: Bearer <TEST_API_KEY> for the named project’s test environment. The scope below is required. A disabled runtime returns 404; missing credentials return 401 and wrong project, environment or scope returns 403. Errors use { error: { code, message } }; preserve the x-correlation-id header for troubleshooting. Amounts are decimal strings in USDC base units (six decimals). Times are Unix seconds. Mandate/action IDs are 32-byte hex strings; project/execution/draft IDs are UUIDs. Read configuration for current limits. Setup and execution deadlines are distinct from RPC blockhash validity.

Operations

createSolanaWebhookEndpoint

POST /v1/projects/{projectId}/solana/webhook-endpoints Scope: webhooks:manage. Response: 201, CreateSolanaWebhookEndpointResponse.

Params

Body

getSolanaConfiguration

GET /v1/projects/{projectId}/solana/configuration Scope: project:read. Response: 200, SolanaConfiguration.

Params

getSolanaOwner

GET /v1/projects/{projectId}/solana/owners/{owner} Scope: accounts:read. Response: 200, OwnerSnapshot.

Params

prepareSolanaMandate

POST /v1/projects/{projectId}/solana/mandates/prepare Scope: mandates:write. Response: 200, PreparedMandate.

Params

Body

confirmSolanaMandate

POST /v1/projects/{projectId}/solana/mandates/confirm Scope: mandates:write. Response: 200 or 202, { draft: DraftView; mandate?: MandateView }.

Params

Body

listSolanaMandates

GET /v1/projects/{projectId}/solana/mandates Scope: mandates:read. Response: 200, { mandates: MandateSummary[] }.

Params

getSolanaMandate

GET /v1/projects/{projectId}/solana/mandates/{mandateId} Scope: mandates:read. Response: 200, MandateView.

Params

listSolanaRefusals

GET /v1/projects/{projectId}/solana/mandates/{mandateId}/refusals Scope: mandates:read. Response: 200, { refusals: Refusal[] }.

Params

prepareSolanaOwnerAction

POST /v1/projects/{projectId}/solana/mandates/{mandateId}/owner-actions/prepare Scope: mandates:write. Response: 200, PreparedOwnerAction.

Params

Body

confirmSolanaOwnerAction

POST /v1/projects/{projectId}/solana/mandates/{mandateId}/owner-actions/confirm Scope: mandates:write. Response: 200 or 202, { draft: DraftView }.

Params

Body

prepareSolanaExecution

POST /v1/projects/{projectId}/solana/executions/prepare Scope: actions:submit. Response: 200, ExecutionView.

Params

Headers

Body

submitSolanaExecution

POST /v1/projects/{projectId}/solana/executions Scope: actions:submit. Response: 202, ExecutionView.

Params

Headers

Body

getSolanaExecution

GET /v1/projects/{projectId}/solana/executions/{executionId} Scope: project:read. Response: 200, ExecutionView.

Params

listSolanaExecutions

GET /v1/projects/{projectId}/solana/executions Scope: project:read. Response: 200, { executions: ExecutionView[] }.

Params

Query

Observation and retries

Confirmation can return 202 while finalized observation is pending. Reuse the same draft and signatures when polling confirmation. Execution preparation and submission require the same idempotency-key (32-byte hex action ID); preserve it with the original input and agent signature. An exact retry reuses the execution and signature. Do not create a new action on an ambiguous response. See execution and finalized status. Manage an explicitly created Solana webhook using the existing project webhook list, enable/disable, delete, rotate-secret, test, and delivery-history APIs in the Base API reference, with a test key and webhooks:manage. Solana event names remain explicit opt-ins; see webhooks.