cosign.eth_verify_attestation

cosign.eth_verify_attestation "oracle_pubkey" Verify an oracle attestation for an Arguments: 1. oracle_pubkey 2. attestation { "version": n, "swap_id": "str", "event_type": "str", "tx_hash": "str", "block_number": n, "block_hash": "str", "contract_address": "str", "token_address": "str", "amount": "str", "recipient": "str", "secret_hash": "str", "timelock": n, "confirmation_depth": n, "attested_at": n, "attestation_hash": "str", "signature": "str", } Result: { (json object) "valid" : true|false, "swap_id" : "str", "confirmation_depth" : n } Examples: > bitcoin-cli cosign.eth_verify_attestation {"version":n,"swap_id":"str","event_type":"str","tx_hash":"str","block_number":n,"block_hash":"str","contract_address":"str","token_address":"str","amount":"str","recipient":"str","secret_hash":"str","timelock":n,"confirmation_depth":n,"attested_at":n,"attestation_hash":"str","signature":"str"} HTLC event. (string, required) 32-byte x-only oracle pubkey (hex) (json object, required) Oracle attestation object (numeric, required) Attestation version (string, required) Swap ID (string, required) Event type (string, required) Transaction hash (numeric, required) Block number (string, required) Block hash (string, required) Contract address (string, required) Token address (string, required) Amount (string, required) Recipient (string, required) Secret hash (numeric, required) Timelock (numeric, required) Confirmation depth (numeric, required) Attestation timestamp (string, required) SHA256 of canonical fields (string, required) Schnorr signature (boolean) Whether attestation is valid (string) Swap ID from attestation (numeric) Confirmation depth "oracle_pubkey_hex" {attestation_json}

Signature

cosign.eth_verify_attestation(oracle_pubkey: string, attestation: object) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"cosign.eth_verify_attestation","params":["\"<oracle_pubkey>\"",{}]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli cosign.eth_verify_attestation "oracle_pubkey_hex" {attestation_json}

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "cosign.eth_verify_attestation",
        "params": ["\"<oracle_pubkey>\"", {}],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "cosign.eth_verify_attestation",
    params: ["\"<oracle_pubkey>\"",{}],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
oracle_pubkey	`string`	yes	32-byte x-only oracle pubkey (hex)
attestation	`object`	yes	Oracle attestation object { "version": n, (numeric, required) Attestation version "swap_id": "str", (string, required) Swap ID "event_type": "str", (string, required) Event type "tx_hash": "str", (string, required) Transaction hash "block_number": n, (numeric, required) Block number "block_hash": "str", (string, required) Block hash "contract_address": "str", (string, required) Contract address "token_address": "str", (string, required) Token address "amount": "str", (string, required) Amount "recipient": "str", (string, required) Recipient "secret_hash": "str", (string, required) Secret hash "timelock": n, (numeric, required) Timelock "confirmation_depth": n, (numeric, required) Confirmation depth "attested_at": n, (numeric, required) Attestation timestamp "attestation_hash": "str", (string, required) SHA256 of canonical fields "signature": "str", (string, required) Schnorr signature }

Result

Type: any

{ (json object) "valid" : true|false, (boolean) Whether attestation is valid "swap_id" : "str", (string) Swap ID from attestation "confirmation_depth" : n (numeric) Confirmation depth }

Source: services/core-node/bcore/src/rpc/cosign.cpp:3541

C++ symbol: cosign_eth_verify_attestation

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"cosign.eth_verify_attestation","params":["\"<oracle_pubkey>\"",{}]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli cosign.eth_verify_attestation "oracle_pubkey_hex" {attestation_json}

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "cosign.eth_verify_attestation",
        "params": ["\"<oracle_pubkey>\"", {}],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "cosign.eth_verify_attestation",
    params: ["\"<oracle_pubkey>\"",{}],
  }),
});
console.log(await res.json());