RFC 6920 SHA-256 Content Name Verification
Verify exact binary content against a canonical authority-free SHA-256 NI name. Return matches, supplied/computed names and byte length; a valid-name mismatch is a useful paid result. Strict RFC 4648 Base64, up to 65536 bytes. Malformed carriers/names refused before payment.
- Price
- from $0.0012 USDC per request (starting price; the 402 response quotes the exact amount for your input)
- Network
- Base mainnet,
eip155:8453, settled in USDC through the Coinbase CDP facilitator - Method and URL
POST https://market.561.group/v1/data/ni-verify- Response type
application/json- Seller
- Causeway Services (561 Group)
Input contract
Input that fails this contract is refused with a 4xx status before any payment is requested.
{
"maxBytes": 102400,
"bodySchema": {
"type": "object",
"additionalProperties": false,
"required": [
"carrier",
"uri"
],
"properties": {
"carrier": {
"type": "object",
"additionalProperties": false,
"required": [
"mediaType",
"contentBase64"
],
"properties": {
"mediaType": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"contentBase64": {
"type": "string",
"maxLength": 87384
}
}
},
"uri": {
"type": "string"
}
}
}
}
Example request
{
"method": "POST",
"url": "https://market.561.group/v1/data/ni-verify",
"headers": {
"accept": "application/json",
"content-type": "application/json"
},
"body": {
"carrier": {
"mediaType": "text/plain",
"contentBase64": "YWJj"
},
"uri": "ni:///sha-256;ungWv48Bz-pBQUDeXa4iI7ADYaOWF3qctBD_YfIAFa0"
}
}
Output
{
"schema": {
"type": "object",
"additionalProperties": false,
"required": [
"matches",
"uri",
"computedUri",
"byteLength"
],
"properties": {
"matches": {
"type": "boolean"
},
"uri": {
"type": "string"
},
"computedUri": {
"type": "string"
},
"byteLength": {
"type": "integer",
"minimum": 0
}
}
},
"example": {
"matches": true,
"uri": "ni:///sha-256;ungWv48Bz-pBQUDeXa4iI7ADYaOWF3qctBD_YfIAFa0",
"computedUri": "ni:///sha-256;ungWv48Bz-pBQUDeXa4iI7ADYaOWF3qctBD_YfIAFa0",
"byteLength": 3
}
}
How to buy with x402
- Send the request without payment. The server answers
402 Payment Requiredwith a base64 JSONPAYMENT-REQUIREDheader holding the amount, asset, network and payee. - Have your wallet sign an EIP-3009
transferWithAuthorizationfor exactly those terms (an x402 client library does this for you). - Repeat the identical request with the signed payload in the
PAYMENT-SIGNATUREheader. - The server verifies, runs the operation, settles, and returns
200with the result and aPAYMENT-RESPONSEheader carrying the settlement receipt.
Read the price without paying
curl --include --request POST --header 'accept: application/json' --header 'content-type: application/json' --data-raw '{"carrier":{"mediaType":"text/plain","contentBase64":"YWJj"},"uri":"ni:///sha-256;ungWv48Bz-pBQUDeXa4iI7ADYaOWF3qctBD_YfIAFa0"}' --url 'https://market.561.group/v1/data/ni-verify'
This request authorizes nothing; it returns the live payment terms. Read the full explanation of x402.
Machine-readable
- /.well-known/x402: x402 discovery document for every offer
- /v1/catalog: full catalog with contracts and examples
- /llms.txt: the market in llms.txt form
- services.561.group: Causeway Services