> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gol.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Solana preview API reference

> Project-scoped devnet request schemas from the deployed runtime, with published SDK response types.

> [!NOTE]
>
> 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](https://docs.gol.network/examples/solana/sdk-reference.md). Solana routes are separate from the unchanged [Base OpenAPI reference](https://docs.gol.network/reference/overview.md). 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

| Method | Route | SDK method | Scope |
| - | - | - | - |
| POST | `/v1/projects/{projectId}/solana/webhook-endpoints` | `createWebhookEndpoint` | `webhooks:manage` |
| GET | `/v1/projects/{projectId}/solana/configuration` | `configuration` | `project:read` |
| GET | `/v1/projects/{projectId}/solana/owners/{owner}` | `owner` | `accounts:read` |
| POST | `/v1/projects/{projectId}/solana/mandates/prepare` | `prepareMandate` | `mandates:write` |
| POST | `/v1/projects/{projectId}/solana/mandates/confirm` | `confirmMandate` | `mandates:write` |
| GET | `/v1/projects/{projectId}/solana/mandates` | `mandates` | `mandates:read` |
| GET | `/v1/projects/{projectId}/solana/mandates/{mandateId}` | `mandate` | `mandates:read` |
| GET | `/v1/projects/{projectId}/solana/mandates/{mandateId}/refusals` | `refusals` | `mandates:read` |
| POST | `/v1/projects/{projectId}/solana/mandates/{mandateId}/owner-actions/prepare` | `prepareOwnerAction` | `mandates:write` |
| POST | `/v1/projects/{projectId}/solana/mandates/{mandateId}/owner-actions/confirm` | `confirmOwnerAction` | `mandates:write` |
| POST | `/v1/projects/{projectId}/solana/executions/prepare` | `prepareExecution` | `actions:submit` |
| POST | `/v1/projects/{projectId}/solana/executions` | `submitExecution` | `actions:submit` |
| GET | `/v1/projects/{projectId}/solana/executions/{executionId}` | `execution` | `project:read` |
| GET | `/v1/projects/{projectId}/solana/executions` | `executions` | `project:read` |

## createSolanaWebhookEndpoint

`POST /v1/projects/{projectId}/solana/webhook-endpoints`

Scope: `webhooks:manage`. Response: **201**, `CreateSolanaWebhookEndpointResponse`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

### Body

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2048
    },
    "description": {
      "type": "string",
      "maxLength": 200
    },
    "eventTypes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "solana_mandate.created",
          "solana_mandate.state_changed",
          "solana_mandate.closed",
          "solana_owner.invalidated",
          "solana_execution.executed",
          "solana_execution.refused",
          "solana_execution.settled"
        ]
      },
      "minItems": 1,
      "uniqueItems": true
    }
  },
  "required": [
    "url",
    "eventTypes"
  ]
}
```

## getSolanaConfiguration

`GET /v1/projects/{projectId}/solana/configuration`

Scope: `project:read`. Response: **200**, `SolanaConfiguration`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

## getSolanaOwner

`GET /v1/projects/{projectId}/solana/owners/{owner}`

Scope: `accounts:read`. Response: **200**, `OwnerSnapshot`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    },
    "owner": {
      "type": "string",
      "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
    }
  },
  "required": [
    "projectId",
    "owner"
  ]
}
```

## prepareSolanaMandate

`POST /v1/projects/{projectId}/solana/mandates/prepare`

Scope: `mandates:write`. Response: **200**, `PreparedMandate`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

### Body

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "owner": {
      "type": "string",
      "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
    },
    "agent": {
      "type": "string",
      "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
    },
    "recipients": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
      },
      "minItems": 1,
      "maxItems": 8
    },
    "maxPerActionBaseUnits": {
      "type": "string",
      "pattern": "^[1-9][0-9]{0,19}$"
    },
    "totalBaseUnits": {
      "type": "string",
      "pattern": "^[1-9][0-9]{0,19}$"
    },
    "maxActions": {
      "type": "integer",
      "minimum": 1
    },
    "rollingWindow": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "seconds": {
          "type": "integer",
          "minimum": 60
        },
        "capBaseUnits": {
          "type": "string",
          "pattern": "^[1-9][0-9]{0,19}$"
        }
      },
      "required": [
        "seconds",
        "capBaseUnits"
      ]
    },
    "validFrom": {
      "type": "integer",
      "minimum": 1,
      "maximum": 281474976710655
    },
    "expiresAt": {
      "type": "integer",
      "minimum": 1,
      "maximum": 281474976710655
    },
    "gas": {
      "type": "boolean"
    }
  },
  "required": [
    "owner",
    "agent",
    "recipients",
    "maxPerActionBaseUnits",
    "totalBaseUnits",
    "expiresAt",
    "gas"
  ]
}
```

## confirmSolanaMandate

`POST /v1/projects/{projectId}/solana/mandates/confirm`

Scope: `mandates:write`. Response: **200 or 202**, `{ draft: DraftView; mandate?: MandateView }`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

### Body

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "draftId": {
      "type": "string",
      "format": "uuid"
    },
    "signatures": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
      },
      "minItems": 1,
      "maxItems": 2
    }
  },
  "required": [
    "draftId",
    "signatures"
  ]
}
```

## listSolanaMandates

`GET /v1/projects/{projectId}/solana/mandates`

Scope: `mandates:read`. Response: **200**, `{ mandates: MandateSummary[] }`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

## getSolanaMandate

`GET /v1/projects/{projectId}/solana/mandates/{mandateId}`

Scope: `mandates:read`. Response: **200**, `MandateView`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    },
    "mandateId": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "projectId",
    "mandateId"
  ]
}
```

## listSolanaRefusals

`GET /v1/projects/{projectId}/solana/mandates/{mandateId}/refusals`

Scope: `mandates:read`. Response: **200**, `{ refusals: Refusal[] }`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    },
    "mandateId": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "projectId",
    "mandateId"
  ]
}
```

## prepareSolanaOwnerAction

`POST /v1/projects/{projectId}/solana/mandates/{mandateId}/owner-actions/prepare`

Scope: `mandates:write`. Response: **200**, `PreparedOwnerAction`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    },
    "mandateId": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "projectId",
    "mandateId"
  ]
}
```

### Body

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "pause",
        "resume",
        "revoke",
        "invalidate",
        "revoke_gas_policy",
        "close",
        "revoke_grant",
        "bump_epoch",
        "spl_revoke"
      ]
    }
  },
  "required": [
    "action"
  ]
}
```

## confirmSolanaOwnerAction

`POST /v1/projects/{projectId}/solana/mandates/{mandateId}/owner-actions/confirm`

Scope: `mandates:write`. Response: **200 or 202**, `{ draft: DraftView }`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    },
    "mandateId": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "projectId",
    "mandateId"
  ]
}
```

### Body

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "draftId": {
      "type": "string",
      "format": "uuid"
    },
    "signatures": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
      },
      "minItems": 1,
      "maxItems": 2
    }
  },
  "required": [
    "draftId",
    "signatures"
  ]
}
```

## prepareSolanaExecution

`POST /v1/projects/{projectId}/solana/executions/prepare`

Scope: `actions:submit`. Response: **200**, `ExecutionView`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

### Headers

```json theme={null}
{
  "type": "object",
  "properties": {
    "idempotency-key": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "idempotency-key"
  ]
}
```

### Body

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "mandateId": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    },
    "recipient": {
      "type": "string",
      "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
    },
    "amountBaseUnits": {
      "type": "string",
      "pattern": "^[1-9][0-9]{0,19}$"
    },
    "deadline": {
      "type": "integer",
      "minimum": 1,
      "maximum": 281474976710655
    }
  },
  "required": [
    "mandateId",
    "recipient",
    "amountBaseUnits",
    "deadline"
  ]
}
```

## submitSolanaExecution

`POST /v1/projects/{projectId}/solana/executions`

Scope: `actions:submit`. Response: **202**, `ExecutionView`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

### Headers

```json theme={null}
{
  "type": "object",
  "properties": {
    "idempotency-key": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "idempotency-key"
  ]
}
```

### Body

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "agentSignature": {
      "type": "string",
      "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,88}$"
    }
  },
  "required": [
    "agentSignature"
  ]
}
```

## getSolanaExecution

`GET /v1/projects/{projectId}/solana/executions/{executionId}`

Scope: `project:read`. Response: **200**, `ExecutionView`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    },
    "executionId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId",
    "executionId"
  ]
}
```

## listSolanaExecutions

`GET /v1/projects/{projectId}/solana/executions`

Scope: `project:read`. Response: **200**, `{ executions: ExecutionView[] }`.

### Params

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "projectId"
  ]
}
```

### Query

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "mandateId": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  }
}
```

## 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](https://docs.gol.network/examples/solana/lifecycle.md).

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](https://docs.gol.network/reference/overview.md), with a test key and `webhooks:manage`. Solana event names remain explicit opt-ins; see [webhooks](https://docs.gol.network/examples/solana/webhooks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.