Research Preview — This API is under development.

Contains

Check if a geometry is inside a container geometry.

POST /compute/v0/contains

Request body

number

required

Target chain ID (e.g., 84532 for Base Sepolia).

Input

required

The containing geometry (typically a polygon). See Input types for accepted formats.

Input

required

The geometry to check — is this inside the container?

string

EAS schema UID. The server uses a default schema if not provided.

string

Ethereum address to receive the attestation. Defaults to the zero address.

Example request

curl -X POST https://staging-api.astral.global/compute/v0/contains \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "chainId": 84532,
    "container": "0xpolygon...",
    "containee": "0xpoint...",
    "recipient": "0xdef456..."
  }'

const response = await fetch('https://staging-api.astral.global/compute/v0/contains', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your-api-key'
  },
  body: JSON.stringify({
    chainId: 84532,
    container: '0xpolygon...',
    containee: '0xpoint...',
    recipient: '0xdef456...'
  })
});

const result = await response.json();

Response

Returns a BooleanComputeResponse.

boolean

required

true if the containee is inside the container, false otherwise.

string

required

Always "contains".

number

required

Unix timestamp of computation.

string[]

required

Array containing [containerRef, containeeRef].

AttestationData

required

Signed EAS attestation. See AttestationData.

DelegatedAttestationData

required

Signature for delegated onchain submission. See DelegatedAttestationData.

Example response

{
  "result": true,
  "operation": "contains",
  "timestamp": 1706400000,
  "inputRefs": [
    "0xpolygon...",
    "0xpoint..."
  ],
  "attestation": {
    "schema": "0x...",
    "attester": "0x590fdb53ed3f0B52694876d42367192a5336700F",
    "recipient": "0xdef456...",
    "data": "0x...",
    "revocable": true,
    "refUID": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "signature": "0x..."
  },
  "delegatedAttestation": {
    "signature": "0x...",
    "attester": "0x590fdb53ed3f0B52694876d42367192a5336700F",
    "deadline": 1706403600,
    "nonce": 0
  }
}

Notes

Uses PostGIS ST_Contains function
The container must completely contain the geometry for true
Points on the boundary may return false — use intersects for boundary cases

The field for the inner geometry is containee, not geometry. This naming distinguishes the two inputs unambiguously.

SDK Method

See astral.compute.contains()