Skip to main content
POST /core/guarantees This endpoint verifies the payer signature, request identity, accepted version, policy, and collateral. V1 guarantees become payable after issuance. V2 guarantees begin in PENDING_VALIDATION.

Authorization

Authorization
string
required
header
Bearer token with guarantee issuance authority.

Request body

claims
object
required
claims.version
number
required
1|2
claims.user_address
string
required
claims.recipient_address
string
required
claims.req_id
string
required
Unique request identifier selected before signing.
claims.amount
string
required
Amount in token base units.
claims.asset_address
string
required
address, or the zero address for ETH.
claims.timestamp
number
required
claims.validation_policy
object
Required for V2 guarantees.
signature
string
required
scheme
string
required
eip712|eip191

Responses

claims
string
required
Hex-encoded BLS certificate claims.
signature
string
required
Hex-encoded BLS signature.
curl -X POST "https://base.sepolia.api.4mica.xyz/core/guarantees" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "claims": {
      "version": 1,
      "user_address": "0x1111111111111111111111111111111111111111",
      "recipient_address": "0x2222222222222222222222222222222222222222",
      "req_id": "0x1",
      "amount": "0x186a0",
      "asset_address": "0x3333333333333333333333333333333333333333",
      "timestamp": 1782122400
    },
    "signature": "0xUserSignature",
    "scheme": "eip712"
  }'
{
  "claims": "0xEncodedCertificateClaims",
  "signature": "0xBlsSignature"
}

Status codes

CodeDescription
200Guarantee accepted and BLS certificate issued.
400Claims, policy, signature, or collateral checks failed.
401The bearer token is missing or invalid.
403The token lacks issuance authority.
409The signed guarantee identity already exists.
500Core could not issue the guarantee.
See transaction lifecycle for V1 and V2 states and signed fields.