docs(tokens): BRC-163 BSV-21 basket profile (BRC-46/100) by GenericCPU · Pull Request #217 · bsv-blockchain/BRCs

GenericCPU · 2026-08-10T22:09:58Z

Summary

Adds BRC-163: application basket profile for BSV-21 fungible value under BRC-46 / BRC-100 (bsv21).
Mirrors BRC-147 for collectables: tags, customInstructions, list / send / internalizeAction, payment separation.
Depends on #213 (BRC-161 / BRC-162). This PR does not redefine token economics — only wallet basket / remittance interop.
Index rows in README.md / SUMMARY.md (placed after 160 until 161/162 land on master).

Motivation

#213 correctly leaves baskets out of scope. Without a shared basket name and remittance contract, wallets cannot hold / list / transfer / import the same tips interoperably. HandCash is already using bsv21 under Collect → Tokens (not Pay / not 1sat).

Test plan

Review against BRC-161/162: BSV-21 fungible tokens (JSON + binary) #213 field names (id underscore, amt string, p/op)
Confirm basket id bsv21 and eligibility (satoshis === 1, value ops only)
Confirm payment-separation guidance matches wallet policy intent
Merge after or with BRC-161/162: BSV-21 fungible tokens (JSON + binary) #213 so ./0161.md / ./0162.md links resolve

Made with Cursor

Companion to shruggr's 161/162: wallet basket `bsv21`, tags/CI remittance, list/send/import — admission stays on-chain, not currency/Pay. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU · 2026-08-10T22:21:02Z

Closing: HandCash is not shipping BSV-21 fungibles without a P2P-scalable conservation proof (no indexer dependency for steady-state). Basket profile deferred with the feature.

Align basket profile with HandCash: holders verify their tips; issuers trusted for mint policy. Global supply-cap audits remain optional. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU · 2026-08-10T22:29:07Z

Reopened with an updated trust model:

Holders verify their tips (local history / remittance).
Issuers are trusted for mint policy — no global supply-cap proof required by this profile.
Still depends on BRC-161/162: BSV-21 fungible tokens (JSON + binary) #213 for on-chain economics; this PR is basket / remittance only.

Define remittance, tagged spend paths (plain / cosigned / refuse), and fail-closed rules. Cosign remains optional; plain owner tips stay valid. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU · 2026-08-10T22:34:21Z

Added an optional cosigner section to BRC-163:

Remittance: cosign.pubkey (+ optional endpoint / feeAddress) and tag cosign:<pubkey>
Tagged spend paths: plain | cosigned | refuse — no silent fallthrough to bare P2PKH
Informative MNEE-shaped script suffix + /v2/transfer API shape
Wallets that don’t implement cosign still forward fields and must not plain-spend cosigned tips

HandCash Desktop mirrors this in bsv21TipKind (detect + refuse until a cosigner client is configured). Cloud already has the MNEE cosigner instrument path.

Reserve id: for per-output identity; CI JSON field id stays BRC-161. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU · 2026-08-10T23:08:07Z

Updated tags per review: token id is bsv21:<tokenId>, not id:<…>.

Bare tag bsv21 still marks the tip under this profile.
id: left free for a per-output identity key (stack-wide lookup).
Inscription / customInstructions JSON field id unchanged (BRC-161).

Align with reference BRC-100 client (tags lowercased ≤300B; internalize CI ≤1000B). Keep id: for per-output list keys. Plain BSV-21 only — MNEE-class cosigner routes stay out of band. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU · 2026-08-10T23:43:04Z

Processed offline feedback:

Tags vs `customInstructions`

Documented the split against the reference client constraints (@bsv/sdk validation):

tags: trim + lowercase, ≤ 300 UTF-8 bytes each
customInstructions on internalizeAction basket insertion: ≤ 1000 UTF-8 bytes
case-preserving display (sym) belongs in CI; sym: tag is legacy/filter-only
id: tag reserved for per-output list key (not BSV-21 token id) — awaiting your remaining id notes this evening

MNEE / cosigner

Removed the interleaved MNEE cosigner API / remittance from the normative profile. Plain owner BSV-21 only (1Sat SDK shape). Non-plain locks fail closed; MNEE stays a separate instrument route (as in Cloud), not part of this basket send surface.

Happy to adjust further when the rest of the id comments land.

Issuers MAY Sigma-sign deploy+mint and mirror pubkey in CI/tags. Unsigned tips remain fully valid; MNEE/cosign stays out of band. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU · 2026-08-11T00:04:37Z

Pushed an update to this branch: optional issuer attestation via Sigma (BRC-77) on deploy+mint, with CI/tag issuer: as a mirror only. Unsigned BSV-21 tips remain fully valid; no global registry or MNEE/cosign in the base remittance path.

shruggr · 2026-08-11T00:47:04Z

+
+| Tag | Requirement | Meaning |
+|-----|-------------|---------|
+| `bsv21` | SHOULD on conforming transfers and imports | Marks the output as a BSV-21 value tip under this profile (no suffix). |


Does this buy anything if you are already in a bsv21 basket, and all rows will have it?

shruggr · 2026-08-11T00:57:41Z

I don't see the cosigner section here any more, but I'm not sure it's actually necessary either, nor any special handling. A token which uses cosigner will always use cosigner and it can be parsed from the output script. There needs to be some other registration of known cosigner API in any wallet that wants to be able to handle those, so I'm not sure that it belongs in this spec for the general token handling. MNEE will work just fine with these rules, you just don't possess the keys to sing it fully, and the app needs to know how to submit.

Require P2P / accompanying BEEF for ticker icon bytes; CI keeps only the outpoint pointer. HTTP content APIs are optional recovery, not normative. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU · 2026-08-11T01:18:28Z

Follow-up: Icon media (P2P)

Updated BRC-163 so ticker icon display does not depend on HTTP content indexers:

CI still carries only the icon outpoint
Writers SHOULD merge the icon inscription tx into transfer/import BEEF
Receivers decode ord envelope bytes locally (and may cache)
Hash identicon remains a UI fallback when no icon / no local bytes

HandCash Desktop implements local cache + BEEF decode (no Gorilla content URL for fungibles).

shruggr · 2026-08-11T06:13:52Z

@GenericCPU I have formalized the id field as brc164. #219

- Point per-output id: at BRC-164 (not token id). - Writers MUST underscore bsv21:<tokenId> values; readers still normalize. - Note fine-grained p bsv21 … permissions out of scope for this profile.

…dump - Tags: bsv21:<id>, amt, dec, icon, optional filters; drop bare bsv21 marker - CI: protocolID/keyID/counterparty; SHOULD sym (case-preserving) - Do not require inscription fields (p/op/id/amt/…) duplicated into CI - Parse token economics from script; BRC-164 for id: list keys

Keep Brandon’s remittance-in-CI model for id/amt/op/sym/dec/icon plus derivation. Tags are exact listOutputs filters (bsv21:<id> primary); amt/sym/dec/icon tags MAY for legacy only. No full inscription JSON required in CI. Reader priority: CI → tags → script.

docs(163): BRC-164 + underscore writers + defer p-scheme

Keep both README index rows: BRC-163 (this draft) and BRC-164 (Output Identity Tags) from master. Co-authored-by: Cursor <cursoragent@cursor.com>

docs(tokens): add BRC-163 BSV-21 basket profile for BRC-46/100

7d6280d

Companion to shruggr's 161/162: wallet basket `bsv21`, tags/CI remittance, list/send/import — admission stays on-chain, not currency/Pay. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU mentioned this pull request Aug 10, 2026

BRC-161/162: BSV-21 fungible tokens (JSON + binary) #213

Merged

1 task

GenericCPU closed this Aug 10, 2026

docs(tokens/0163): trusted-issuer tip verify, not global supply proofs

dcd9661

Align basket profile with HandCash: holders verify their tips; issuers trusted for mint policy. Global supply-cap audits remain optional. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU reopened this Aug 10, 2026

docs(tokens/0163): optional cosigner gate for BSV-21 basket tips

0aa4953

Define remittance, tagged spend paths (plain / cosigned / refuse), and fail-closed rules. Cosign remains optional; plain owner tips stay valid. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU marked this pull request as draft August 10, 2026 22:39

docs(tokens/0163): tag token id as bsv21:<id>, not id:

0177eba

Reserve id: for per-output identity; CI JSON field id stays BRC-161. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU mentioned this pull request Aug 10, 2026

docs(147): id/type tags, origin forms, tags vs CI #206

Closed

3 tasks

docs(tokens/0163): optional issuer attestation (Sigma)

f9ca6ce

Issuers MAY Sigma-sign deploy+mint and mirror pubkey in CI/tags. Unsigned tips remain fully valid; MNEE/cosign stays out of band. Co-authored-by: Cursor <cursoragent@cursor.com>

shruggr reviewed Aug 11, 2026

View reviewed changes

docs(tokens/0163): icon media via BEEF, not content indexers

10095cb

Require P2P / accompanying BEEF for ticker icon bytes; CI keeps only the outpoint pointer. HTTP content APIs are optional recovery, not normative. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU mentioned this pull request Aug 14, 2026

docs(tokens): draft BRC-165 P1Sat collectable permission scheme #221

Closed

7 tasks

shruggr mentioned this pull request Aug 18, 2026

docs(tokens): draft BRC-165 P1Sat permission scheme #229

Merged

3 tasks

shruggr added 6 commits August 18, 2026 13:08

docs(163): BRC-164 id tags; underscore writers; defer p-scheme

edbb87b

- Point per-output id: at BRC-164 (not token id). - Writers MUST underscore bsv21:<tokenId> values; readers still normalize. - Note fine-grained p bsv21 … permissions out of scope for this profile.

docs(163): positive tags/CI placement only; drop prohibition lists

cf2b89e

docs(163): bsv21: and amt tags are always from the tip

a72e306

docs(163): dec and icon tags SHOULD when known

4170bc1

docs(163): issuer is filter tag only, not CI

badf87b

shruggr and others added 6 commits August 18, 2026 14:17

docs(163): deploy/auth tags SHOULD when applicable

2c43047

docs(163): clarify id: tag is BRC-164 SHOULD

d70ea07

docs(163): op tag is this output's op

72777b6

Merge pull request #1 from shruggr/docs/brc-163-polish

cd920f4

docs(163): BRC-164 + underscore writers + defer p-scheme

Merge upstream/master into docs/brc-163-bsv21-basket

8a1a4f2

Keep both README index rows: BRC-163 (this draft) and BRC-164 (Output Identity Tags) from master. Co-authored-by: Cursor <cursoragent@cursor.com>

GenericCPU marked this pull request as ready for review August 18, 2026 22:11

sirdeggen merged commit 5e5189c into bsv-blockchain:master Aug 28, 2026

Navigation Menu

Uh oh!

docs(tokens): BRC-163 BSV-21 basket profile (BRC-46/100) - #217

docs(tokens): BRC-163 BSV-21 basket profile (BRC-46/100)#217
sirdeggen merged 19 commits into
bsv-blockchain:masterfrom
GenericCPU:docs/brc-163-bsv21-basket

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 11, 2026

Uh oh!

shruggr Aug 11, 2026

Uh oh!

shruggr commented Aug 11, 2026

Uh oh!

GenericCPU commented Aug 11, 2026

Uh oh!

shruggr commented Aug 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

GenericCPU commented Aug 10, 2026

Summary

Motivation

Test plan

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Uh oh!

GenericCPU commented Aug 10, 2026

Tags vs customInstructions

MNEE / cosigner

Uh oh!

GenericCPU commented Aug 11, 2026

Uh oh!

shruggr Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

shruggr commented Aug 11, 2026

Uh oh!

GenericCPU commented Aug 11, 2026

Follow-up: Icon media (P2P)

Uh oh!

shruggr commented Aug 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Tags vs `customInstructions`