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.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 sameidempotency-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.