repo.collect_acceptance

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

repo.collect_acceptance "offer_id" Join a cosign session via invite link This is a convenience wrapper that Arguments: 1. offer_id (string, required) 2. invite_link (string, required) 3. timeout_ms (numeric, optional) 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" } }, "cosign" : { "session_id" : "str", "peer_sas" : "str", "messages_received" : n } } Examples: > bitcoin-cli repo.collect_acceptance "invite_link" ( timeout_ms ) and collect acceptance data from counterparty. combines cosign.join with cosign.recv and repo.import_acceptance. Repo offer identifier Cosign invite link (cosign:?r=...) Timeout for receiving acceptance (default: 30000ms) (json object) (string) Acceptance identifier (json object) Imported acceptance payload (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 (json object) Cosign session details (string) Cosign session identifier (string) Peer Short Authentication String (numeric) Number of messages received aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa "cosign:?r=abc123&t=websocket#c=alpha-bravo-charlie"

Signature

repo.collect_acceptance(offer_id: string, invite_link: string, timeout_ms?: number) → any

Code samples

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

bitcoin-cli repo.collect_acceptance aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa "cosign:?r=abc123&t=websocket#c=alpha-bravo-charlie"

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

Parameters

Name	Type	Req.	Description
offer_id	`string`	yes	Repo offer identifier
invite_link	`string`	yes	Cosign invite link (cosign:?r=...)
timeout_ms	`number`	—	Timeout for receiving acceptance (default: 30000ms)

Result

Type: any

{ (json object) "accept_id" : "hex", (string) Acceptance identifier "acceptance" : { (json object) Imported acceptance payload "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 } }, "cosign" : { (json object) Cosign session details "session_id" : "str", (string) Cosign session identifier "peer_sas" : "str", (string) Peer Short Authentication String "messages_received" : n (numeric) Number of messages received } }

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

C++ symbol: repo_collect_acceptance

Code samples

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

bitcoin-cli repo.collect_acceptance aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa "cosign:?r=abc123&t=websocket#c=alpha-bravo-charlie"

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