Create an anchor

Creates a new anchor record in the system.

POST
/anchors

Authorization

AuthorizationBearer <token>

JWT signed by private key. The presence of this token is not mandatory. It becomes required through the configuration of authorization access rules that requires a token to grant access. Once sent, the token is validated for its format, signature and expiration, regardless of the presence of access rules.

In: header

Header Parameters

x-ledger?handle | luid

The unique identifier of ledger in context for multi tenant requests.

Request Body

Anchor body

hashhash
Match^[A-Fa-f0-9]{64}$
metabase-meta
dataanchor-data

Response Body

const body = JSON.stringify({
  "hash": "6fbba0181fc0177365b62541ed7e94d8532ca6dd40651f23387d4c17d00967ec",
  "data": {
    "handle": "svgs:-vqibKLJKikP@teslabank.io",
    "wallet": "tel:7027156866",
    "target": "tran:254085257323@minka.io",
    "symbol": "usd",
    "custom": {
      "name": "Chaz",
      "idType": "nidn",
      "idNumber": "IJdEsSmS",
      "entityType": "individual"
    },
    "access": [
      {
        "action": "any",
        "signer": {
          "public": "gef6OID0o7ZFGTXutV62mh+zv5kgkFP3QLiR+N7syck="
        }
      },
      {
        "action": "read",
        "bearer": {
          "$signer": {
            "$record": "owner"
          }
        }
      }
    ]
  },
  "meta": {
    "proofs": [
      {
        "method": "ed25519-v2",
        "public": "gef6OID0o7ZFGTXutV62mh+zv5kgkFP3QLiR+N7syck=",
        "digest": "88bd7a67baa761c8c68032b4d9aaef82ff1e89149b3ab6c532723836c6f88a3c",
        "result": "UaQ97057qBTyl8SanZ64TL1IvGZdXQKDkktCMt/BaSJFdLO/oJvm3NC/MM64ZEUlDWGskrU7kVRUG/hfaxF4Bw==",
        "custom": {
          "moment": "2025-04-02T05:10:31.483Z",
          "status": "created"
        }
      }
    ]
  }
})

fetch("http://localhost:3000/v2/anchors", {
  headers: {
    "x-ledger": "string"
  },
  body
})

{
  "hash": "6fbba0181fc0177365b62541ed7e94d8532ca6dd40651f23387d4c17d00967ec",
  "data": {
    "handle": "svgs:-vqibKLJKikP@teslabank.io",
    "wallet": "tel:7027156866",
    "target": "tran:254085257323@minka.io",
    "symbol": "usd",
    "custom": {
      "name": "Chaz",
      "idType": "nidn",
      "idNumber": "IJdEsSmS",
      "entityType": "individual"
    },
    "access": [
      {
        "action": "any",
        "signer": {
          "public": "gef6OID0o7ZFGTXutV62mh+zv5kgkFP3QLiR+N7syck="
        }
      },
      {
        "action": "read",
        "bearer": {
          "$signer": {
            "$record": "owner"
          }
        }
      }
    ]
  },
  "luid": "$anc.-0847869HxNkGI2-Z",
  "meta": {
    "proofs": [
      {
        "custom": {
          "moment": "2025-04-02T05:10:31.483Z",
          "status": "created"
        },
        "digest": "88bd7a67baa761c8c68032b4d9aaef82ff1e89149b3ab6c532723836c6f88a3c",
        "method": "ed25519-v2",
        "public": "gef6OID0o7ZFGTXutV62mh+zv5kgkFP3QLiR+N7syck=",
        "result": "UaQ97057qBTyl8SanZ64TL1IvGZdXQKDkktCMt/BaSJFdLO/oJvm3NC/MM64ZEUlDWGskrU7kVRUG/hfaxF4Bw=="
      },
      {
        "custom": {
          "luid": "$anc.-0847869HxNkGI2-Z",
          "moment": "2025-04-02T05:10:31.503Z",
          "status": "created"
        },
        "digest": "1d2c782e3fefb90213d77e3970ece504f7e50ac0a869383c8e917586b484f166",
        "method": "ed25519-v2",
        "public": "SYqAsweCOCByOQrC9DSjAmIVlyocndNaB/GyjxfQY5U=",
        "result": "O2Wt+7bw7QOM1FbAL/uwTc+zoh0E/WoRqSk5+9hmBI/NZGCOfYntFs7yjpKozb20KPS0UYqfkh9gbyQf160zBA=="
      }
    ],
    "status": "created",
    "moment": "2025-04-02T05:10:31.498Z",
    "owners": [
      "gef6OID0o7ZFGTXutV62mh+zv5kgkFP3QLiR+N7syck="
    ]
  }
}

{
  "hash": "7846195d1e2f8bc75aa0ab35a238b70dc28c809b8fde33ea7d29e9f8d6d6841b",
  "data": {
    "reason": "auth.unauthorized",
    "detail": "Invalid token."
  },
  "meta": {
    "proofs": [
      {
        "method": "ed25519-v2",
        "public": "JdK8m5SqXGCiZ1TdXQbCe9ECqwL3Kg1UZxj4r9gT+cA=",
        "digest": "7846195d1e2f8bc75aa0ab35a238b70dc28c809b8fde33ea7d29e9f8d6d6841b",
        "result": "X2m5A9Yxh4FRPgj6wgJKN0dYrfgXSq3hx8UX1jnmJ7fVHtQCnAp8MepXDZQhNkMsJd7a9HPk96hmvYXTFcHzAw=="
      }
    ]
  }
}

{
  "hash": "4969e3c012b66d88cec597bf337fc01eab8d651e6ed2d5c40236cc1f7d93435a",
  "data": {
    "reason": "auth.forbidden",
    "detail": "Request is not authorized"
  },
  "meta": {
    "proofs": [
      {
        "method": "ed25519-v2",
        "public": "WAweF9PHlboQoW0z8NqhZXFmzUTaV74NRFAd/aILprE=",
        "digest": "4969e3c012b66d88cec597bf337fc01eab8d651e6ed2d5c40236cc1f7d93435a",
        "result": "0G2gvSfBx6MwPT8ShBaiYx7zwa5Kqc4Cq3S3NXV1m5/ZPozoH/SUouuhi9sQU+f0yo0eX4ygH7PzE3PAdlxsCQ=="
      }
    ]
  }
}

{
  "hash": "9e518d3f4a7c8b67ad43fcf9b6a21e0c5f9b2a5e7d6c3b8a1f4e7d0c9b8a7f5e",
  "data": {
    "reason": "record.duplicated",
    "detail": "Ledger with handle ach already exists."
  },
  "meta": {
    "proofs": [
      {
        "method": "ed25519-v2",
        "public": "QpI4V3K6NzJLbRWCGxdHF7XYT9w2jVkArMpLoFa84s4=",
        "digest": "9e518d3f4a7c8b67ad43fcf9b6a21e0c5f9b2a5e7d6c3b8a1f4e7d0c9b8a7f5e",
        "result": "jR3PQvN7Dy4GcXshzZIa5qd6me9CyiTUwRlJo8fkHpv2jlYE+Hx/D0FSrT2y6MCcSjFnV3dlUmWxJrb5F+kzDQ=="
      }
    ]
  }
}

{
  "hash": "3f6e9d2c5b8a1f4e7d0c3b6a9f2e5d8c1b4a7f0e3d6c9b2a5f8e1d4c7b0a3f6e",
  "data": {
    "reason": "record.schema-invalid",
    "detail": "Schema validator error: data.handle must match pattern \"^[a-zA-Z0-9_\\\\-+.]+$\"",
    "custom": {
      "errors": [
        {
          "instancePath": "/handle",
          "schemaPath": "#/properties/handle/pattern",
          "keyword": "pattern",
          "params": {
            "pattern": "^[a-zA-Z0-9_\\\\-+.]+$"
          },
          "message": "must match pattern \"^[a-zA-Z0-9_\\\\-+.]+$\""
        }
      ]
    }
  },
  "meta": {
    "proofs": [
      {
        "method": "ed25519-v2",
        "public": "vL8jKxm5PqTnJfEaRs2uOdY7gzX4CS9WbHlN3cAiBV0=",
        "digest": "3f6e9d2c5b8a1f4e7d0c3b6a9f2e5d8c1b4a7f0e3d6c9b2a5f8e1d4c7b0a3f6e",
        "result": "uYxJLd2QGkEfT8rP7mCn1lHVzBvIaSK4jFqpO5ZwW9oADnMbg6yeiUsvN3tcXj0RwYxkrq5aLm9f4y2Ko8WwDw=="
      }
    ]
  }
}

{
  "hash": "e1d4c7b0a3f6e9d2c5b8a1f4e7d0c3b6a9f2e5d8c1b4a7f0e3d6c9b2a5f8e1d4",
  "data": {
    "reason": "api.unexpected-error",
    "detail": "An unexpected error occurred"
  },
  "meta": {
    "proofs": [
      {
        "method": "ed25519-v2",
        "public": "KxiLpB3v8VEdmYsT2RwNq5o1Cz9gHJfU4aAySt7D0X8=",
        "digest": "e1d4c7b0a3f6e9d2c5b8a1f4e7d0c3b6a9f2e5d8c1b4a7f0e3d6c9b2a5f8e1d4",
        "result": "LzRmNh7x5TQYoqjw30BKDaZnbGcFUsX8v4tpEsr9P6iW1dyJkVC2uALfY8HdpM3eX9w0On12cqYxEtveKoFZDQ=="
      }
    ]
  }
}