Research Preview — This API is under development.

Distance

Calculate the distance between two geometries in meters.

POST /compute/v0/distance

Request body

number

required

Target chain ID. All UIDs must exist on this chain.

Input

required

First geometry. See Input types for accepted formats.

Input

required

Second geometry.

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/distance \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "chainId": 84532,
    "from": "0xabc123...",
    "to": {
      "type": "Point",
      "coordinates": [2.2945, 48.8584]
    },
    "recipient": "0xdef456..."
  }'

const response = await fetch('https://staging-api.astral.global/compute/v0/distance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your-api-key'
  },
  body: JSON.stringify({
    chainId: 84532,
    from: '0xabc123...',
    to: { type: 'Point', coordinates: [2.2945, 48.8584] },
    recipient: '0xdef456...'
  })
});

const result = await response.json();

Response

Returns a NumericComputeResponse.

number

required

Distance in meters (e.g., 523.45).

string

required

Always "meters".

string

required

Always "distance".

number

required

Unix timestamp of computation.

string[]

required

Array of input references (UIDs or geometry hashes).

AttestationData

required

Signed EAS attestation. See AttestationData.

DelegatedAttestationData

required

Signature for delegated onchain submission. See DelegatedAttestationData.

Example response

{
  "result": 523.45,
  "units": "meters",
  "operation": "distance",
  "timestamp": 1706400000,
  "inputRefs": [
    "0xabc123...",
    "0x7d3e8f..."
  ],
  "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

Distance is calculated using PostGIS ST_Distance with geodetic coordinates
Result is in meters with centimeter precision
The onchain attested value is scaled to centimeters (integer) for EVM compatibility
For raw GeoJSON inputs, a keccak256 hash is used in inputRefs

SDK Method

See astral.compute.distance()