repo.accept

workflowrepo-lifecycle·step 3 of 10Workflow: repo-lifecycle · step 3 of 10

repo.accept "id" ( {"repay_ad Record acceptance for a repo offer IMPORTANT: Review terms carefully before Arguments: 1. id (string, 2. options (json { "repay_address": "str", "confirmed": bool, } Result: { "accept_id" : "hex", "acceptance" : { "version" : n, "contract_type" : "str", "offer_id" : "hex", "id" : "hex", "sinks_ack" : { "repay_spk" : "hex" }, "fs_policy_ack" : { "require_adaptor" : true|false, "reveal_lockstep" : true|false }, "fs_tx_adaptor_point" : "hex", "salt" : "hex", "commitment" : "hex", "borrower_internal_key" : "hex", "lender_internal_key" : "hex", "repay_templates" : [ { "purpose" : "str", "is_native" : true|false, "units" : n, "script_pubkey" : "hex", "commitment" : "hex", "asset_id" : "hex", "vext" : "hex" }, ... ], "default_collateral_template" : { "purpose" : "str", "is_native" : true|false, "units" : n, "script_pubkey" : "hex", "commitment" : "hex", "asset_id" : "hex", "vext" : "hex" } }, "terms" : {} "action_required" : "str", "warning" : "str" } Examples: > bitcoin-cli repo.accept "offer_id& (shows terms for review) > bitcoin-cli repo.accept "offer_id" (accepts after review) dress":"str","confirmed":bool} ) and return the canonical acceptance payload. accepting. Use 'confirmed' parameter to proceed. required) Repo offer identifier object, optional) Acceptance options (string, optional) Updated repayment address (bech32m) (boolean, optional) Must be true after reviewing terms to accept (json object) (string, optional) Acceptance identifier (only if confirmed=true) (json object, optional) Canonical acceptance payload (only if confirmed=true) (numeric) Acceptance payload version (string) Contract type (repo) (string) Offer identifier (string) Acceptance identifier (json object) Acknowledged sink set (string) Hex-encoded Taproot repayment script acknowledged by the counterparty (json object) Acknowledged Fair-Sign policy (boolean) Require adaptor signatures (Fair-Sign) (boolean) Enforce lock-step final signature reveal (string) Counterparty adaptor point (x-only, hex) (string) Acceptance salt (string) Acceptance commitment (string, optional) Borrower's internal key for vault construction (x-only, hex) (string, optional) Untweaked lender key (x-only, hex) (json array, optional) Pre-built repayment delivery templates (json object) (string) Template purpose (repay_principal, repay_interest, or repay_merged) (boolean) Whether repayment is native BTC (numeric) Raw units represented by the template (string) Destination scriptPubKey (string) Commitment hash over script and TLV metadata (string, optional) Asset identifier when non-native (string, optional) Asset TLV bytes when non-native (json object, optional) Pre-built collateral sweep template (string) Template purpose (default_collateral) (boolean) Whether sweep is native BTC (numeric) Raw units represented by the template (string) Destination scriptPubKey (string) Commitment hash over script and TLV metadata (string, optional) Asset identifier when non-native (string, optional) Asset TLV bytes when non-native (empty JSON object, optional) Contract terms for review (if confirmed is missing/false) (string, optional) Instructions for user (if confirmed is missing/false) (string, optional) Warning message (if confirmed is missing/false) quot; '{"confirmed": true}'

Signature

repo.accept(id: string, options?: object) → any

Code samples

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

bitcoin-cli repo.accept "offer_id"

bitcoin-cli repo.accept "offer_id" '{"confirmed": true}'

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "repo.accept",
        "params": ["\"<id>\"", {}],
    },
    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: "repo.accept",
    params: ["\"<id>\"",{}],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
id	`string`	yes	Repo offer identifier
options	`object`	—	Acceptance options { "repay_address": "str", (string, optional) Updated repayment address (bech32m) "confirmed": bool, (boolean, optional) Must be true after reviewing terms to accept }

Result

Type: any

{ (json object) "accept_id" : "hex", (string, optional) Acceptance identifier (only if confirmed=true) "acceptance" : { (json object, optional) Canonical acceptance payload (only if confirmed=true) "version" : n, (numeric) Acceptance payload version "contract_type" : "str", (string) Contract type (repo) "offer_id" : "hex", (string) Offer identifier "id" : "hex", (string) Acceptance identifier "sinks_ack" : { (json object) Acknowledged sink set "repay_spk" : "hex" (string) Hex-encoded Taproot repayment script acknowledged by the counterparty }, "fs_policy_ack" : { (json object) Acknowledged Fair-Sign policy "require_adaptor" : true|false, (boolean) Require adaptor signatures (Fair-Sign) "reveal_lockstep" : true|false (boolean) Enforce lock-step final signature reveal }, "fs_tx_adaptor_point" : "hex", (string) Counterparty adaptor point (x-only, hex) "salt" : "hex", (string) Acceptance salt "commitment" : "hex", (string) Acceptance commitment "borrower_internal_key" : "hex", (string, optional) Borrower's internal key for vault construction (x-only, hex) "lender_internal_key" : "hex", (string, optional) Untweaked lender key (x-only, hex) "repay_templates" : [ (json array, optional) Pre-built repayment delivery templates { (json object) "purpose" : "str", (string) Template purpose (repay_principal, repay_interest, or repay_merged) "is_native" : true|false, (boolean) Whether repayment is native BTC "units" : n, (numeric) Raw units represented by the template "script_pubkey" : "hex", (string) Destination scriptPubKey "commitment" : "hex", (string) Commitment hash over script and TLV metadata "asset_id" : "hex", (string, optional) Asset identifier when non-native "vext" : "hex" (string, optional) Asset TLV bytes when non-native }, ... ], "default_collateral_template" : { (json object, optional) Pre-built collateral sweep template "purpose" : "str", (string) Template purpose (default_collateral) "is_native" : true|false, (boolean) Whether sweep is native BTC "units" : n, (numeric) Raw units represented by the template "script_pubkey" : "hex", (string) Destination scriptPubKey "commitment" : "hex", (string) Commitment hash over script and TLV metadata "asset_id" : "hex", (string, optional) Asset identifier when non-native "vext" : "hex" (string, optional) Asset TLV bytes when non-native } }, "terms" : {} (empty JSON object, optional) Contract terms for review (if confirmed is missing/false) "action_required" : "str", (string, optional) Instructions for user (if confirmed is missing/false) "warning" : "str" (string, optional) Warning message (if confirmed is missing/false) }

Source: services/core-node/bcore/src/wallet/rpc/contracts.cpp:3286

C++ symbol: repo_accept

Code samples

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

bitcoin-cli repo.accept "offer_id"

bitcoin-cli repo.accept "offer_id" '{"confirmed": true}'

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "repo.accept",
        "params": ["\"<id>\"", {}],
    },
    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: "repo.accept",
    params: ["\"<id>\"",{}],
  }),
});
console.log(await res.json());