@smartledger/bsv 7.3.0 → 7.4.0

package/docs/MODULE_REFERENCE_COMPLETE.md

@@ -55,19 +55,19 @@ Three advanced modules totaling **~2.7MB** of functionality:
 - **Purpose**: Threshold cryptography for secure secret distribution
 - **Use Cases**: Backup keys, multi-party security, key recovery
 - **Features**: Split secrets into N shares, require M to reconstruct
-- **CDN**: `unpkg.com/@smartledger/bsv@7.3.0/bsv-shamir.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@7.4.0/bsv-shamir.min.js`
 
 #### **🌐 Global Digital Attestation Framework - GDAF (1184KB)**  
 - **Purpose**: W3C Verifiable Credentials and decentralized identity
 - **Use Cases**: Identity verification, attestations, zero-knowledge proofs
 - **Features**: DID creation, credential issuance, selective disclosure
-- **CDN**: `unpkg.com/@smartledger/bsv@7.3.0/bsv-gdaf.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@7.4.0/bsv-gdaf.min.js`
 
 #### **⚖️ Legal Token Protocol - LTP (1184KB)**
 - **Purpose**: Legal compliance framework for tokenized assets
 - **Use Cases**: Property rights, obligations, compliant tokenization  
 - **Features**: Legal primitives, compliance checking, attestation anchoring
-- **CDN**: `unpkg.com/@smartledger/bsv@7.3.0/bsv-ltp.min.js`
+- **CDN**: `unpkg.com/@smartledger/bsv@7.4.0/bsv-ltp.min.js`
 
 ### **2. Incorrect File Sizes in Documentation**
 
@@ -81,18 +81,18 @@ Three advanced modules totaling **~2.7MB** of functionality:
 
 | Module | Size | Use Case | CDN Link |
 |--------|------|----------|----------|
-| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js` |
-| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.3.0/bsv.bundle.js` |
-| **bsv-smartcontract.min.js** | 937KB | Covenant development | `unpkg.com/@smartledger/bsv@7.3.0/bsv-smartcontract.min.js` |
-| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.3.0/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.3.0/bsv-script-helper.min.js` |
-| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.3.0/bsv-security.min.js` |
-| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.3.0/bsv-ecies.min.js` |
-| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.3.0/bsv-message.min.js` |
-| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.3.0/bsv-mnemonic.min.js` |
-| **🆕 bsv-shamir.min.js** | 432KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@7.3.0/bsv-shamir.min.js` |
-| **🆕 bsv-gdaf.min.js** | 1184KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@7.3.0/bsv-gdaf.min.js` |
-| **🆕 bsv-ltp.min.js** | 1184KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@7.3.0/bsv-ltp.min.js` |
+| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js` |
+| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.4.0/bsv.bundle.js` |
+| **bsv-smartcontract.min.js** | 937KB | Covenant development | `unpkg.com/@smartledger/bsv@7.4.0/bsv-smartcontract.min.js` |
+| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.4.0/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.4.0/bsv-script-helper.min.js` |
+| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.4.0/bsv-security.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.4.0/bsv-ecies.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.4.0/bsv-message.min.js` |
+| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.4.0/bsv-mnemonic.min.js` |
+| **🆕 bsv-shamir.min.js** | 432KB | **Secret sharing** | `unpkg.com/@smartledger/bsv@7.4.0/bsv-shamir.min.js` |
+| **🆕 bsv-gdaf.min.js** | 1184KB | **Digital attestation** | `unpkg.com/@smartledger/bsv@7.4.0/bsv-gdaf.min.js` |
+| **🆕 bsv-ltp.min.js** | 1184KB | **Legal tokens** | `unpkg.com/@smartledger/bsv@7.4.0/bsv-ltp.min.js` |
 
 ## 🎯 **Updated Usage Examples**
 
@@ -100,22 +100,22 @@ Three advanced modules totaling **~2.7MB** of functionality:
 
 #### **1. Basic Development (~963KB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-script-helper.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-script-helper.min.js"></script>
 ```
 
 #### **2. Smart Contract Development (~2.7MB — each bundle re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-smartcontract.min.js"></script>
 ```
 
 #### **3. 🆕 Legal & Compliance Development (~3.2MB — each bundle re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const legalToken = bsv.createLegalToken({
@@ -132,9 +132,9 @@ Three advanced modules totaling **~2.7MB** of functionality:
 
 #### **4. 🆕 Security & Cryptography (~1.4MB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-shamir.min.js"></script>
 <script>
   // Shamir Secret Sharing
   const shares = bsv.splitSecret('my_secret_key', 5, 3); // 5 shares, 3 needed
@@ -146,7 +146,7 @@ Three advanced modules totaling **~2.7MB** of functionality:
 
 #### **5. Everything Bundle (937KB)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.bundle.js"></script>
 <script>
   // Everything available immediately
   const shares = bsv.splitSecret('secret', 5, 3);

package/docs/advanced/UTXO_MANAGER_GUIDE.md

@@ -722,7 +722,7 @@ interface UTXO {
 <html>
 <head>
     <title>UTXO Manager Demo</title>
-    <script src="https://cdn.jsdelivr.net/npm/@smartledger/bsv@7.3.0/bsv.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@smartledger/bsv@7.4.0/bsv.min.js"></script>
 </head>
 <body>
     <script>

package/docs/getting-started/INSTALLATION.md

@@ -48,7 +48,7 @@ const tx: Transaction = new Transaction();
 #### **Core Library Only (937KB)**
 For basic Bitcoin SV operations:
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
 <script>
   const privateKey = new bsv.PrivateKey();
   const address = privateKey.toAddress();
@@ -58,7 +58,7 @@ For basic Bitcoin SV operations:
 #### **Complete Bundle (937KB)**  
 Everything in one file:
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.bundle.js"></script>
 <script>
   // All features available immediately
   const shares = bsv.splitSecret('secret', 5, 3);
@@ -71,9 +71,9 @@ Everything in one file:
 
 #### **Smart Contract Development (~2.7MB total — each bundle is self-contained and re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-covenant.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-covenant.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-smartcontract.min.js"></script>
 <script>
   const covenant = bsv.SmartContract.createCovenantBuilder()
     .extractField('amount').push(50000).greaterThanOrEqual().build();
@@ -82,9 +82,9 @@ Everything in one file:
 
 #### **Legal & Identity Development (~3.2MB total — each bundle is self-contained and re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-gdaf.min.js"></script>
 <script>
   // Legal Token Protocol
   const propertyToken = bsv.createPropertyToken({
@@ -98,9 +98,9 @@ Everything in one file:
 
 #### **Security & Cryptography (~1.4MB total — each bundle is self-contained and re-embeds core BSV)**
 ```html
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-security.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-shamir.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-security.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-shamir.min.js"></script>
 <script>
   // Threshold Cryptography
   const shares = bsv.splitSecret('my_secret_key', 5, 3);
@@ -114,18 +114,18 @@ Everything in one file:
 
 | Module | Size | Purpose | CDN Link |
 |--------|------|---------|----------|
-| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js` |
-| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.3.0/bsv.bundle.js` |
-| **bsv-smartcontract.min.js** | 937KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@7.3.0/bsv-smartcontract.min.js` |
-| **bsv-ltp.min.js** | 1184KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@7.3.0/bsv-ltp.min.js` |
-| **bsv-gdaf.min.js** | 1184KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@7.3.0/bsv-gdaf.min.js` |
-| **bsv-shamir.min.js** | 432KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@7.3.0/bsv-shamir.min.js` |
-| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.3.0/bsv-security.min.js` |
-| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.3.0/bsv-mnemonic.min.js` |
-| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.3.0/bsv-ecies.min.js` |
-| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.3.0/bsv-covenant.min.js` |
-| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.3.0/bsv-script-helper.min.js` |
-| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.3.0/bsv-message.min.js` |
+| **bsv.min.js** | 937KB | Core BSV + SmartContract | `unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js` |
+| **bsv.bundle.js** | 937KB | Everything in one file | `unpkg.com/@smartledger/bsv@7.4.0/bsv.bundle.js` |
+| **bsv-smartcontract.min.js** | 937KB | Complete covenant framework | `unpkg.com/@smartledger/bsv@7.4.0/bsv-smartcontract.min.js` |
+| **bsv-ltp.min.js** | 1184KB | **Legal Token Protocol** | `unpkg.com/@smartledger/bsv@7.4.0/bsv-ltp.min.js` |
+| **bsv-gdaf.min.js** | 1184KB | **Digital Identity & Attestation** | `unpkg.com/@smartledger/bsv@7.4.0/bsv-gdaf.min.js` |
+| **bsv-shamir.min.js** | 432KB | **Threshold Cryptography** | `unpkg.com/@smartledger/bsv@7.4.0/bsv-shamir.min.js` |
+| **bsv-security.min.js** | 26KB | Security enhancements (opt-in helpers — see README › Security) | `unpkg.com/@smartledger/bsv@7.4.0/bsv-security.min.js` |
+| **bsv-mnemonic.min.js** | 681KB | HD wallets | `unpkg.com/@smartledger/bsv@7.4.0/bsv-mnemonic.min.js` |
+| **bsv-ecies.min.js** | 71KB | Encryption | `unpkg.com/@smartledger/bsv@7.4.0/bsv-ecies.min.js` |
+| **bsv-covenant.min.js** | 913KB | Covenant operations | `unpkg.com/@smartledger/bsv@7.4.0/bsv-covenant.min.js` |
+| **bsv-script-helper.min.js** | 26KB | Custom script tools | `unpkg.com/@smartledger/bsv@7.4.0/bsv-script-helper.min.js` |
+| **bsv-message.min.js** | 26KB | Message signing | `unpkg.com/@smartledger/bsv@7.4.0/bsv-message.min.js` |
 
 ## ⚙️ **Development Environment Setup**
 

package/docs/getting-started/QUICK_START.md

@@ -14,10 +14,10 @@ npm install @smartledger/bsv
 ### Browser CDN (Instant)
 ```html
 <!-- Core library (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
 
 <!-- Everything included (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.bundle.js"></script>
 ```
 
 ## 💰 **Your First Transaction (60 seconds)**
@@ -127,19 +127,19 @@ SmartLedger-BSV offers 12 different loading options - use only what you need:
 
 ```html
 <!-- Core BSV only (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
 
 <!-- Smart contracts (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-smartcontract.min.js"></script>
 
 <!-- Legal tokens (1.16MB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-ltp.min.js"></script>
 
 <!-- Digital identity (1.16MB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-gdaf.min.js"></script>
 
 <!-- Everything (937KB) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.bundle.js"></script>
 ```
 
 ## ⚡ **Key Advantages**

package/docs/migration/FROM_BSV_1_5_6.md

@@ -159,17 +159,17 @@ const recovered = bsv.reconstructSecret([shares[0], shares[2], shares[4]]);
 ### **New Modular Options** 
 ```html
 <!-- Core compatibility (same size as bsv@1.5.6) -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.min.js"></script>
 
 <!-- Add smart contracts when ready -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-smartcontract.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-smartcontract.min.js"></script>
 
 <!-- Add advanced features as needed -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-ltp.min.js"></script>
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv-gdaf.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-ltp.min.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv-gdaf.min.js"></script>
 
 <!-- Everything in one file -->
-<script src="https://unpkg.com/@smartledger/bsv@7.3.0/bsv.bundle.js"></script>
+<script src="https://unpkg.com/@smartledger/bsv@7.4.0/bsv.bundle.js"></script>
 ```
 
 ## 🔍 **Testing Your Migration**

package/lib/ordinals/README.md

@@ -176,10 +176,17 @@ B.buildDeploy({ address: owner, tick: 'ORDI', max: '21000000', lim: '1000', dec:
 B.buildMint({ address: owner, tick: 'ORDI', amt: '1000' })
 B.buildTransfer({ address: newOwner, tick: 'ORDI', amt: '250' })
 
-// v2 / BSV-21: deploy+mint a supply, transfer by id.
+// v2 / BSV-21, fixed supply: deploy+mint, then transfer by id.
 B.buildDeployMint({ address: owner, amt: '1000000', dec: 8, sym: 'XYZ' })
 B.buildTransfer({ address: newOwner, id: deployTxid + '_0', amt: '5' })
 
+// v2 / BSV-21, authority model: no supply at deploy; an auth output carries the right
+// to mint, and minting names the token by id (and needs an auth input on chain).
+B.buildDeployAuth({ address: owner, sym: 'STABLE', dec: 6 })
+B.buildAuth({ address: minter, id: deployTxid + '_0' })       // delegate mint authority
+B.buildMint({ address: holder, id: deployTxid + '_0', amt: '1000000' })
+B.buildBurn({ address: holder, id: deployTxid + '_0', amt: '400' })
+
 // 1-sat outputs and parsing.
 var out = B.createMintOutput({ address: owner, tick: 'ORDI', amt: '1' })
 B.isBsv20(out.script)                 // true
@@ -201,10 +208,12 @@ it — so a stray object can no longer be written as the literal text `[object O
 **`parseBsv20` / `isBsv20` enforce validity rather than assuming it.** The operation must be
 one the spec defines and must carry the fields that operation requires — a `transfer` with no
 amount and no token, an `auth` carrying `amt` (which the spec forbids), an over-uint64 amount,
-or an unknown `op` all return `null`. Operations this library does not yet *build* are still
-*read*: `burn`, `auth`, and `deploy+auth` parse correctly. Non-canonical amounts (leading
-zeros) are tolerated when reading other people's payloads, though our builders always emit
-canonical ones.
+or an unknown `op` all return `null`. Every operation the spec defines is both built and
+read. Non-canonical amounts (leading zeros) are tolerated when reading other people's
+payloads, though our builders always emit canonical ones.
+
+An operation names its token by `tick` (v1) **or** `id` (BSV-21), never both — passing both
+throws rather than silently picking one, since they are different tokens.
 
 Balance tracking is an indexer concern — this module builds and reads the on-chain payloads.
 
@@ -222,5 +231,6 @@ Balance tracking is an indexer concern — this module builds and reads the on-c
 | `payOutputFor` | build a P2PKH payment output |
 | `ORDLOCK_SIGHASH` | `SIGHASH_ALL\|ANYONECANPAY\|FORKID` (0xc1) |
 | `BSV20.buildDeploy` / `buildMint` / `buildTransfer` / `buildDeployMint` | build BSV-20/21 token inscriptions |
+| `BSV20.buildDeployAuth` / `buildAuth` / `buildBurn` | BSV-21 authority model: deploy without supply, delegate mint rights, burn |
 | `BSV20.create*Output` | 1-sat token outputs |
 | `BSV20.parseBsv20`, `BSV20.isBsv20` | read a token payload back |

package/lib/ordinals/bsv20.js

@@ -143,9 +143,38 @@ function buildDeploy (params) {
  * @param {object} params { tick, amt, address|lock, contentType? }
  * @returns {Script}
  */
+/**
+ * Name the token an operation acts on: `tick` (v1) or `id` (BSV-21), never both.
+ * Passing both used to silently drop the `tick`, which is the wrong token, not a preference.
+ */
+function assignToken (p, params, op) {
+  var hasTick = params.tick != null
+  var hasId = params.id != null
+  if (hasTick && hasId) {
+    throw new Error(op + ' names a token by `tick` (v1) or `id` (BSV-21), not both')
+  }
+  if (!hasTick && !hasId) {
+    throw new Error(op + ' requires `tick` (v1) or `id` (BSV-21)')
+  }
+  if (hasId) p.id = assertId(params.id)
+  else p.tick = assertTick(params.tick)
+  return p
+}
+
+/** Reject `amt` on the operations the spec says must not carry one. */
+function assertNoAmt (params, op) {
+  if (params.amt != null) {
+    throw new Error(op + ' must not carry an amt — the specification forbids it, and a ' +
+      'payload that does is discarded')
+  }
+}
+
 function buildMint (params) {
   params = params || {}
-  var p = { p: 'bsv-20', op: 'mint', tick: assertTick(params.tick), amt: normPositive(params.amt, 'amt') }
+  // `{p, op, tick|id, amt}` — the token first, then the amount.
+  var p = { p: 'bsv-20', op: 'mint' }
+  assignToken(p, params, 'mint')
+  p.amt = normPositive(params.amt, 'amt')
   return buildBsv20(p, params)
 }
 
@@ -157,8 +186,63 @@ function buildMint (params) {
 function buildTransfer (params) {
   params = params || {}
   var p = { p: 'bsv-20', op: 'transfer', amt: normPositive(params.amt, 'amt') }
-  if (params.id != null) p.id = assertId(params.id)
-  else p.tick = assertTick(params.tick)
+  assignToken(p, params, 'transfer')
+  return buildBsv20(p, params)
+}
+
+/**
+ * Burn an amount of a BSV-21 token: `{p, op:'burn', id, amt}`.
+ *
+ * BSV-21 (id-based) only — the specification defines `burn` under BSV-21, so there is no
+ * ticker form. To retire v1 supply, transfer it to an unspendable output instead.
+ *
+ * @param {object} params { id, amt, address|lock, contentType? }
+ * @returns {Script}
+ */
+function buildBurn (params) {
+  params = params || {}
+  if (params.tick != null) {
+    throw new Error('burn is a BSV-21 operation and names its token by `id` (<txid>_<vout>), ' +
+      'not `tick`')
+  }
+  var p = { p: 'bsv-20', op: 'burn', id: assertId(params.id), amt: normPositive(params.amt, 'amt') }
+  return buildBsv20(p, params)
+}
+
+/**
+ * Deploy a BSV-21 token under an AUTHORITY rather than a fixed supply:
+ * `{p, op:'deploy+auth', sym?, dec?, icon?}`.
+ *
+ * Unlike `deploy+mint`, no supply is created here — minting happens later via `buildMint`
+ * against this deploy's outpoint, and requires an auth input. The spec is explicit that
+ * `amt` must NOT be present.
+ *
+ * @param {object} params { sym?, dec?, icon?, address|lock, contentType? }
+ * @returns {Script}
+ */
+function buildDeployAuth (params) {
+  params = params || {}
+  assertNoAmt(params, 'deploy+auth')
+  var p = { p: 'bsv-20', op: 'deploy+auth' }
+  if (params.dec != null) p.dec = normDec(params.dec)
+  if (params.sym != null) p.sym = assertText(params.sym, 'sym')
+  if (params.icon != null) p.icon = assertIcon(params.icon)
+  return buildBsv20(p, params)
+}
+
+/**
+ * Mint authority for a BSV-21 token: `{p, op:'auth', id}`.
+ *
+ * The output this locks carries the right to mint the token, and "can be split, combined,
+ * or transferred to delegate minting authority". It carries no amount — `amt` is forbidden.
+ *
+ * @param {object} params { id, address|lock, contentType? }
+ * @returns {Script}
+ */
+function buildAuth (params) {
+  params = params || {}
+  assertNoAmt(params, 'auth')
+  var p = { p: 'bsv-20', op: 'auth', id: assertId(params.id) }
   return buildBsv20(p, params)
 }
 
@@ -186,6 +270,9 @@ function createDeployOutput (params) { return outputFor(buildDeploy(params), par
 function createMintOutput (params) { return outputFor(buildMint(params), params && params.satoshis) }
 function createTransferOutput (params) { return outputFor(buildTransfer(params), params && params.satoshis) }
 function createDeployMintOutput (params) { return outputFor(buildDeployMint(params), params && params.satoshis) }
+function createBurnOutput (params) { return outputFor(buildBurn(params), params && params.satoshis) }
+function createDeployAuthOutput (params) { return outputFor(buildDeployAuth(params), params && params.satoshis) }
+function createAuthOutput (params) { return outputFor(buildAuth(params), params && params.satoshis) }
 
 /** Extract the JSON body from a locking script, a JSON string, a Buffer, or an object. */
 function bodyOf (input) {
@@ -283,10 +370,16 @@ module.exports = {
   buildMint: buildMint,
   buildTransfer: buildTransfer,
   buildDeployMint: buildDeployMint,
+  buildBurn: buildBurn,
+  buildDeployAuth: buildDeployAuth,
+  buildAuth: buildAuth,
   createDeployOutput: createDeployOutput,
   createMintOutput: createMintOutput,
   createTransferOutput: createTransferOutput,
   createDeployMintOutput: createDeployMintOutput,
+  createBurnOutput: createBurnOutput,
+  createDeployAuthOutput: createDeployAuthOutput,
+  createAuthOutput: createAuthOutput,
   parseBsv20: parseBsv20,
   isBsv20: isBsv20
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartledger/bsv",
-  "version": "7.3.0",
+  "version": "7.4.0",
   "description": "🚀 Complete Bitcoin SV development framework with legally-recognizable DID:web + W3C VC-JWT toolkit, Legal Token Protocol (LTP), Global Digital Attestation Framework (GDAF), StatusList2021 revocation, and 16 flexible loading options. Standards-based credentials with ES256/ES256K support, on-chain BSV anchoring, and comprehensive Bitcoin SV API. Perfect for legal tokens, verifiable credentials, DeFi, smart contracts, and secure Bitcoin applications.",
   "author": "SmartLedger Technology <hello@smartledger.technology> (https://smartledger.technology)",
   "homepage": "https://github.com/codenlighten/smartledger-bsv#readme",

package/test/ordinals/bsv20.js

@@ -216,7 +216,122 @@ describe('Ordinals BSV-20 fungible tokens', function () {
         B.isBsv20(B.buildMint({ address: address, tick: 'ORDI', amt: '1' })).should.equal(true)
         B.isBsv20(B.buildTransfer({ address: address, id: OUTPOINT, amt: '1' })).should.equal(true)
         B.isBsv20(B.buildDeployMint({ address: address, amt: '1000' })).should.equal(true)
+        B.isBsv20(B.buildBurn({ address: address, id: OUTPOINT, amt: '1' })).should.equal(true)
+        B.isBsv20(B.buildAuth({ address: address, id: OUTPOINT })).should.equal(true)
+        B.isBsv20(B.buildDeployAuth({ address: address, sym: 'STABLE' })).should.equal(true)
       })
     })
   })
+
+  // BSV-21 authority model: deploy+auth creates no supply, an auth output carries the right
+  // to mint, and mint names its token by `id`. Previously only the fixed-supply deploy+mint
+  // path could be built, so these operations could be read but never written.
+  describe('BSV-21 authority operations', function () {
+    var OUTPOINT = '3b31'.repeat(16) + '_0'
+
+    it('mints by id, which requires an auth input on chain', function () {
+      var p = B.parseBsv20(B.buildMint({ address: address, id: OUTPOINT, amt: '1000000' }))
+      p.op.should.equal('mint')
+      p.id.should.equal(OUTPOINT)
+      p.amt.should.equal('1000000')
+      ;(p.tick === undefined).should.equal(true)
+    })
+
+    it('leaves the v1 ticker mint byte-for-byte unchanged', function () {
+      var p = B.parseBsv20(B.buildMint({ address: address, tick: 'ORDI', amt: '1000' }))
+      JSON.stringify(p).should.equal('{"p":"bsv-20","op":"mint","tick":"ORDI","amt":"1000"}')
+    })
+
+    it('refuses to guess which token an operation means', function () {
+      // Naming both used to silently drop the tick — a different token, not a preference.
+      (function () {
+        B.buildMint({ address: address, tick: 'ORDI', id: OUTPOINT, amt: '1' })
+      }).should.throw(/not both/)
+      ;(function () {
+        B.buildTransfer({ address: address, tick: 'ORDI', id: OUTPOINT, amt: '1' })
+      }).should.throw(/not both/)
+      ;(function () {
+        B.buildMint({ address: address, amt: '1' })
+      }).should.throw(/requires `tick` \(v1\) or `id`/)
+    })
+
+    it('builds a burn', function () {
+      var p = B.parseBsv20(B.buildBurn({ address: address, id: OUTPOINT, amt: '5' }))
+      p.op.should.equal('burn')
+      p.id.should.equal(OUTPOINT)
+      p.amt.should.equal('5')
+    })
+
+    it('rejects a ticker burn, which the spec does not define', function () {
+      (function () {
+        B.buildBurn({ address: address, tick: 'ORDI', amt: '5' })
+      }).should.throw(/BSV-21 operation/)
+    })
+
+    it('builds deploy+auth with no supply', function () {
+      var p = B.parseBsv20(B.buildDeployAuth({ address: address, sym: 'STABLE', dec: 6 }))
+      p.op.should.equal('deploy+auth')
+      p.sym.should.equal('STABLE')
+      p.dec.should.equal('6')
+      ;(p.amt === undefined).should.equal(true)
+      // Every field is optional.
+      B.parseBsv20(B.buildDeployAuth({ address: address })).op.should.equal('deploy+auth')
+    })
+
+    it('builds an auth output carrying no amount', function () {
+      var p = B.parseBsv20(B.buildAuth({ address: address, id: OUTPOINT }))
+      p.op.should.equal('auth')
+      p.id.should.equal(OUTPOINT)
+      ;(p.amt === undefined).should.equal(true)
+    })
+
+    it('refuses to attach an amt where the spec forbids one', function () {
+      (function () {
+        B.buildAuth({ address: address, id: OUTPOINT, amt: '1' })
+      }).should.throw(/must not carry an amt/)
+      ;(function () {
+        B.buildDeployAuth({ address: address, sym: 'X', amt: '1' })
+      }).should.throw(/must not carry an amt/)
+    })
+
+    it('applies the same amount rules as the other operations', function () {
+      (function () {
+        B.buildBurn({ address: address, id: OUTPOINT, amt: '0' })
+      }).should.throw(/greater than zero/)
+      ;(function () {
+        B.buildBurn({ address: address, id: OUTPOINT, amt: '9'.repeat(26) })
+      }).should.throw(/exceeds the uint64 maximum/)
+      ;(function () {
+        B.buildMint({ address: address, id: 'notanid', amt: '1' })
+      }).should.throw(/<txid>/)
+      ;(function () {
+        B.buildDeployAuth({ address: address, sym: {} })
+      }).should.throw(/sym must be a string/)
+    })
+
+    it('builds 1-sat outputs for each new operation', function () {
+      var outs = [
+        B.createBurnOutput({ address: address, id: OUTPOINT, amt: '5' }),
+        B.createAuthOutput({ address: address, id: OUTPOINT }),
+        B.createDeployAuthOutput({ address: address, sym: 'STABLE' })
+      ]
+      outs.forEach(function (o) {
+        o.satoshis.should.equal(1)
+        B.isBsv20(o.script).should.equal(true)
+      })
+    })
+
+    it('round-trips a full authority lifecycle', function () {
+      // deploy+auth -> auth output delegating mint rights -> mint by id -> burn.
+      var deploy = B.parseBsv20(B.buildDeployAuth({ address: address, sym: 'GOLD', dec: 8 }))
+      var auth = B.parseBsv20(B.buildAuth({ address: address, id: OUTPOINT }))
+      var mint = B.parseBsv20(B.buildMint({ address: address, id: OUTPOINT, amt: '1000' }))
+      var burn = B.parseBsv20(B.buildBurn({ address: address, id: OUTPOINT, amt: '400' }))
+      deploy.op.should.equal('deploy+auth')
+      auth.op.should.equal('auth')
+      mint.amt.should.equal('1000')
+      burn.amt.should.equal('400')
+      ;[deploy, auth, mint, burn].forEach(function (p) { p.p.should.equal('bsv-20') })
+    })
+  })
 })

package/version.js

@@ -1,3 +1,3 @@
 'use strict'
 // GENERATED by scripts/sync-version.js on `npm version` — do not edit.
-module.exports = '7.3.0'
+module.exports = '7.4.0'