@dignetwork/chip35-dl-coin-wasm 0.8.0 → 0.9.0

package/chip35_dl_coin_wasm.d.ts

@@ -233,13 +233,25 @@ export interface CatInfo {
     p2PuzzleHash: Uint8Array;
 }
 
-/** A buyer's CAT coin (as `chip0002_getAssetCoins` returns it) for `buildCatPayment`. */
+/** A buyer's CAT coin (as `chip0002_getAssetCoins` returns it) for `buildCatPayment` / `buildDigStorePayment`. */
 export interface Cat {
     coin: Coin;
     lineageProof?: LineageProof | null;
     info: CatInfo;
 }
 
+/**
+ * The cross-system $DIG-payment constants (mainnet), returned by `digConstants()`. Minting a store is
+ * FREE of $DIG; a CAPSULE (commit / root-advance) pays the per-capsule price in $DIG to
+ * `treasuryInnerPuzzleHash`. Byte-identical across the ecosystem (digstore-chain / hub).
+ */
+export interface DigConstants {
+    /** The DIG CAT asset id (TAIL hash), 32 bytes. */
+    assetId: Uint8Array;
+    /** The DIG treasury's inner (standard) puzzle hash every per-capsule payment settles to, 32 bytes. */
+    treasuryInnerPuzzleHash: Uint8Array;
+}
+
 /** The verifiable description of a payment's on-chain commitment. */
 export interface PaymentReceipt {
     ownerPuzzleHash: Uint8Array;
@@ -365,6 +377,18 @@ export function buildCatPayment(buyer_synthetic_key: Uint8Array, selected_cats:
  */
 export function buildChip0007Metadata(metadata: Chip0007Metadata): Chip0007MetadataResult;
 
+/**
+ * Build the (UNSIGNED) DIG-CAT coin spends that pay `amount` base units of $DIG to the DIG treasury
+ * for a capsule (commit) — the canonical per-capsule store payment (see
+ * [`chip35_dl_coin::build_dig_store_payment`]). `dig_cats` is the buyer's `Cat[]` of the DIG asset
+ * (as `chip0002_getAssetCoins` returns them); `store_id` is the capsule's launcher id (= store id);
+ * `amount` is the dynamic, USD-pegged per-capsule price in DIG base units (an INPUT — never
+ * hardcoded). The caller concatenates the returned `CoinSpend[]` with the commit's
+ * `updateStoreMetadata` spends and signs the whole bundle. MINT does NOT call this (mint is free of
+ * $DIG). Returns `CoinSpend[]`.
+ */
+export function buildDigStorePayment(buyer_synthetic_key: Uint8Array, dig_cats: Cat[], store_id: Uint8Array, amount: bigint): CoinSpend[];
+
 /**
  * Build the coin spends for a buyer to pay the dapp owner `amount` mojos of **XCH** (#46 payment).
  * `selected_coins` is the buyer's XCH `Coin[]`; `nonce` is the 32-byte unlock nonce. Returns
@@ -408,6 +432,22 @@ export function dataStoreFromSpend(coin_spend: CoinSpend, prev_delegated_puzzles
  */
 export function decodeOffer(text: string): SpendBundle;
 
+/**
+ * The cross-system $DIG-payment constants (mainnet): the DIG CAT `assetId` and the treasury INNER
+ * `puzzleHash` every per-capsule payment settles to. Byte-identical across the ecosystem
+ * (digstore-chain / hub). Lets an agent/consumer read them at runtime instead of hardcoding. Returns
+ * `{ assetId: Uint8Array, treasuryInnerPuzzleHash: Uint8Array }`.
+ */
+export function digConstants(): DigConstants;
+
+/**
+ * The DIG-CAT payment coin a capsule (commit) pays to the treasury — what `buildDigStorePayment`
+ * emits (see [`chip35_dl_coin::dig_treasury_payment_coin`]). `lead_dig_cat` is the lead DIG `Cat`
+ * (its id is the new coin's parent); `amount` is the payment in DIG base units. Lets a caller pin /
+ * verify the exact expected treasury coin without re-deriving the CAT wrap. Returns a `Coin`.
+ */
+export function digTreasuryPaymentCoin(lead_dig_cat: Cat, amount: bigint): Coin;
+
 /**
  * Derive the digstore-scoped owner discovery hint for a 32-byte owner puzzle hash. The app
  * computes the SAME hint to enumerate the wallet's stores via coinset

package/chip35_dl_coin_wasm.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./chip35_dl_coin_wasm_bg.js";
 __wbg_set_wasm(wasm);
 
 export {
-    addFee, adminDelegatedPuzzleFromKey, buildCatPayment, buildChip0007Metadata, buildPayment, bulkMint, capabilities, createDid, dataStoreFromSpend, decodeOffer, digstoreOwnerHint, encodeOffer, generateItemMetadata, hexSpendBundleToCoinSpends, init, issueCat, meltStore, mintNft, mintStore, oracleDelegatedPuzzle, oracleSpend, paymentNonce, proveCollectionMembership, proveNftOwnership, readNftOwnership, sha256, spendBundleToHex, updateStoreMetadata, updateStoreOwnership, validateChip0007, verifyPaymentReceipt, version, writerDelegatedPuzzleFromKey
+    addFee, adminDelegatedPuzzleFromKey, buildCatPayment, buildChip0007Metadata, buildDigStorePayment, buildPayment, bulkMint, capabilities, createDid, dataStoreFromSpend, decodeOffer, digConstants, digTreasuryPaymentCoin, digstoreOwnerHint, encodeOffer, generateItemMetadata, hexSpendBundleToCoinSpends, init, issueCat, meltStore, mintNft, mintStore, oracleDelegatedPuzzle, oracleSpend, paymentNonce, proveCollectionMembership, proveNftOwnership, readNftOwnership, sha256, spendBundleToHex, updateStoreMetadata, updateStoreOwnership, validateChip0007, verifyPaymentReceipt, version, writerDelegatedPuzzleFromKey
 } from "./chip35_dl_coin_wasm_bg.js";

package/chip35_dl_coin_wasm_bg.js

@@ -110,6 +110,41 @@ export function buildChip0007Metadata(metadata) {
     }
 }
 
+/**
+ * Build the (UNSIGNED) DIG-CAT coin spends that pay `amount` base units of $DIG to the DIG treasury
+ * for a capsule (commit) — the canonical per-capsule store payment (see
+ * [`chip35_dl_coin::build_dig_store_payment`]). `dig_cats` is the buyer's `Cat[]` of the DIG asset
+ * (as `chip0002_getAssetCoins` returns them); `store_id` is the capsule's launcher id (= store id);
+ * `amount` is the dynamic, USD-pegged per-capsule price in DIG base units (an INPUT — never
+ * hardcoded). The caller concatenates the returned `CoinSpend[]` with the commit's
+ * `updateStoreMetadata` spends and signs the whole bundle. MINT does NOT call this (mint is free of
+ * $DIG). Returns `CoinSpend[]`.
+ * @param {Uint8Array} buyer_synthetic_key
+ * @param {Cat[]} dig_cats
+ * @param {Uint8Array} store_id
+ * @param {bigint} amount
+ * @returns {CoinSpend[]}
+ */
+export function buildDigStorePayment(buyer_synthetic_key, dig_cats, store_id, amount) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passArray8ToWasm0(buyer_synthetic_key, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(store_id, wasm.__wbindgen_export);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.buildDigStorePayment(retptr, ptr0, len0, addHeapObject(dig_cats), ptr1, len1, amount);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return takeObject(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
 /**
  * Build the coin spends for a buyer to pay the dapp owner `amount` mojos of **XCH** (#46 payment).
  * `selected_coins` is the buyer's XCH `Coin[]`; `nonce` is the 32-byte unlock nonce. Returns
@@ -263,6 +298,43 @@ export function decodeOffer(text) {
     }
 }
 
+/**
+ * The cross-system $DIG-payment constants (mainnet): the DIG CAT `assetId` and the treasury INNER
+ * `puzzleHash` every per-capsule payment settles to. Byte-identical across the ecosystem
+ * (digstore-chain / hub). Lets an agent/consumer read them at runtime instead of hardcoding. Returns
+ * `{ assetId: Uint8Array, treasuryInnerPuzzleHash: Uint8Array }`.
+ * @returns {DigConstants}
+ */
+export function digConstants() {
+    const ret = wasm.digConstants();
+    return takeObject(ret);
+}
+
+/**
+ * The DIG-CAT payment coin a capsule (commit) pays to the treasury — what `buildDigStorePayment`
+ * emits (see [`chip35_dl_coin::dig_treasury_payment_coin`]). `lead_dig_cat` is the lead DIG `Cat`
+ * (its id is the new coin's parent); `amount` is the payment in DIG base units. Lets a caller pin /
+ * verify the exact expected treasury coin without re-deriving the CAT wrap. Returns a `Coin`.
+ * @param {Cat} lead_dig_cat
+ * @param {bigint} amount
+ * @returns {Coin}
+ */
+export function digTreasuryPaymentCoin(lead_dig_cat, amount) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.digTreasuryPaymentCoin(retptr, addHeapObject(lead_dig_cat), amount);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return takeObject(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
 /**
  * Derive the digstore-scoped owner discovery hint for a 32-byte owner puzzle hash. The app
  * computes the SAME hint to enumerate the wallet's stores via coinset

package/package.json

@@ -2,7 +2,7 @@
   "name": "@dignetwork/chip35-dl-coin-wasm",
   "type": "module",
   "description": "WebAssembly bindings for the isolated CHIP-0035 DataLayer store coin driver.",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "license": "MIT",
   "repository": {
     "type": "git",