Blockchain

Blockchain synchronization operations for syncing entities to Solana blockchain

Prepare blockchain sync transaction

post

Prepares a blockchain transaction for syncing an entity (Zone, Pin, GCP, or File) to the Solana blockchain. Returns transaction metadata and data that the client will sign and send. Authentication required.

Authorizations

DynamicAuth

X-Dynamic-User-IdstringRequired

Dynamic authentication header. Required for blockchain endpoints and other authenticated operations.

Body

application/json

entityTypestring · enumRequired

Type of entity to sync to blockchain

Possible values:

entityIdinteger · min: 1Required

ID of the entity to sync

networkstring · enumOptional

Solana network to use (defaults to devnet if not specified)

Possible values:

Responses

200

Transaction prepared successfully

application/json

or

400

Bad request - invalid input or wallet address not found

application/json

401

Unauthorized - authentication required

application/json

404

Entity not found

application/json

500

Internal server error - failed to prepare sync

application/json

post

/blockchain/sync

HTTPcURLJavaScriptPython

POST /api/blockchain/sync HTTP/1.1
X-Dynamic-User-Id: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "entityType": "Zone",
  "entityId": 1,
  "network": "devnet"
}

{
  "success": true,
  "metadata": {
    "entityType": "Zone",
    "entityId": 1,
    "title": "text",
    "geojson": {},
    "geoPose": {},
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "transactionData": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "network": "devnet"
}

Confirm blockchain transaction

post

Records a confirmed blockchain transaction in the database after it has been signed and sent by the client. Verifies the transaction status and updates the entity's blockchain sync status. Authentication required.

Authorizations

DynamicAuth

X-Dynamic-User-IdstringRequired

Dynamic authentication header. Required for blockchain endpoints and other authenticated operations.

Body

application/json

entityTypestring · enumRequired

Type of entity that was synced

Possible values:

entityIdinteger · min: 1Required

ID of the entity that was synced

signaturestring · min: 1Required

Transaction signature from Solana blockchain

networkstring · enumOptional

Solana network used for the transaction

Possible values:

blockHeightinteger · min: 1Optional

Block height at which the transaction was confirmed (optional)

Responses

200

Transaction confirmed successfully

application/json

or

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required

application/json

500

Internal server error - failed to confirm transaction

application/json

post

/blockchain/confirm

HTTPcURLJavaScriptPython

POST /api/blockchain/confirm HTTP/1.1
X-Dynamic-User-Id: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 88

{
  "entityType": "Zone",
  "entityId": 1,
  "signature": "text",
  "network": "devnet",
  "blockHeight": 1
}

{
  "success": true,
  "signature": "text",
  "explorerUrl": "https://example.com"
}

Mark blockchain sync as failed

post

Marks an entity's blockchain sync as failed (e.g., when transaction is cancelled or fails). Authentication required.

Authorizations

DynamicAuth

X-Dynamic-User-IdstringRequired

Dynamic authentication header. Required for blockchain endpoints and other authenticated operations.

Body

application/json

entityTypestring · enumRequired

Type of entity to sync to blockchain

Possible values:

entityIdinteger · min: 1Required

ID of the entity to sync

networkstring · enumOptional

Solana network to use (defaults to devnet if not specified)

Possible values:

Responses

200

Sync marked as failed successfully

application/json

successbooleanOptionalExample: true

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required

application/json

500

Internal server error - failed to mark sync as failed

application/json

post

/blockchain/fail

HTTPcURLJavaScriptPython

POST /api/blockchain/fail HTTP/1.1
X-Dynamic-User-Id: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "entityType": "Zone",
  "entityId": 1,
  "network": "devnet"
}

{
  "success": true
}