Research Preview — This API is under development.

Length

Calculate the length of a line in meters.

POST /compute/v0/length

Request body

number

required

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

Input

required

The line geometry to measure. See Input types for accepted formats.

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/length \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "chainId": 84532,
    "geometry": "0xline...",
    "recipient": "0xdef456..."
  }'

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

const result = await response.json();

Response

Returns a NumericComputeResponse.

number

required

Length in meters (e.g., 2345.67).

string

required

Always "meters".

string

required

Always "length".

number

required

Unix timestamp of computation.

string[]

required

Array of input references.

AttestationData

required

Signed EAS attestation. See AttestationData.

DelegatedAttestationData

required

Signature for delegated onchain submission. See DelegatedAttestationData.

Example response

{
  "result": 2345.67,
  "units": "meters",
  "operation": "length",
  "timestamp": 1706400000,
  "inputRefs": [
    "0xline..."
  ],
  "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_Length with geodetic calculation
Result is in meters with centimeter precision
The onchain attested value is scaled to centimeters (integer) for EVM compatibility
Valid for LineString and MultiLineString geometries

SDK Method

See astral.compute.length()

​Length

​Request body

​Example request

​Response

​Example response

​Notes

SDK Method

Length

Request body

Example request

Response

Example response

Notes