Language

Choose a language

/build/rpc / cosign / discussion

cosign.discussion_list

cosign.discussion_list "scope_type" "scope_id" ( since limit force_refresh ) List discussion posts for a model-scoped thread. Retrieves posts from the bridge, then verifies each proof locally using strict rules (confirmed UTXOs, bestblock chain binding, BIP-322). Arguments: 1. scope_type (string, required) Scope type: "model_prealert" or "model_challenge" 2. scope_id (string, required) Scope ID: model_hash or challenge_block_hash (64 hex chars) 3. since (numeric, optional, default=0) Only return posts after this unix timestamp 4. limit (numeric, optional, default=100) Maximum number of posts to return 5. force_refresh (boolean, optional, default=false) Force relay re-query (bypass bridge cache) Result: { (json object) "current_height" : n, (numeric) Current block height "stale" : true|false, (boolean, optional) Whether cached posts are being returned after a relay refresh failure "refresh_error" : "str", (string, optional) Relay refresh failure that caused a stale cached result "posts" : [ (json array) { (json object) "post_id" : "str", (string) Nostr event ID "author_pubkey" : "str", (string) Author Nostr pubkey "content" : "str", (string) Message text "model_identifier" : "str", (string, optional) Human-readable model_name@commit_id alias carried with the post "created_at" : n, (numeric) Unix timestamp "has_proof" : true|false, (boolean) Whether a proof was attached "verified" : true|false, (boolean) Whether the proof passed verification "rejected_reason" : "str", (string, optional) Reason proof failed "verified_units" : n, (numeric, optional) Verified stake in satoshis "expiry_height" : n (numeric, optional) Proof expiry block height }, ... ] } Examples: > bitcoin-cli cosign.discussion_list "model_prealert" "abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789"

Signature

cosign.discussion_list(scope_type: string, scope_id: string, since?: number, limit?: number, force_refresh?: boolean) → any

Code samples

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

Parameters

NameTypeReq.Description
scope_typestringyesScope type: "model_prealert" or "model_challenge"
scope_idstringyesScope ID: model_hash or challenge_block_hash (64 hex chars)
sincenumberOnly return posts after this unix timestamp
limitnumberMaximum number of posts to return
force_refreshbooleanForce relay re-query (bypass bridge cache)

Result

Type:  any

{ (json object) "current_height" : n, (numeric) Current block height "stale" : true|false, (boolean, optional) Whether cached posts are being returned after a relay refresh failure "refresh_error" : "str", (string, optional) Relay refresh failure that caused a stale cached result "posts" : [ (json array) { (json object) "post_id" : "str", (string) Nostr event ID "author_pubkey" : "str", (string) Author Nostr pubkey "content" : "str", (string) Message text "model_identifier" : "str", (string, optional) Human-readable model_name@commit_id alias carried with the post "created_at" : n, (numeric) Unix timestamp "has_proof" : true|false, (boolean) Whether a proof was attached "verified" : true|false, (boolean) Whether the proof passed verification "rejected_reason" : "str", (string, optional) Reason proof failed "verified_units" : n, (numeric, optional) Verified stake in satoshis "expiry_height" : n (numeric, optional) Proof expiry block height }, ... ] }

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

C++ symbol: cosign_discussion_list