@kaspacom/kcc20-tx-builder 0.8.0-fee.1 → 0.8.0-fee.3

package/dist/escrow-receipt.js

@@ -0,0 +1,287 @@
+import { blake2b } from "@noble/hashes/blake2b";
+import { sha256 } from "@noble/hashes/sha256";
+import { assertKcc20ArtifactScriptHash } from "./artifacts.js";
+import { normalizeSilverScriptArtifact, templateHash } from "./abi.js";
+import { KCC20_ESCROW_MAX_INT, KCC20_ESCROW_MIN_FEE_SOMPI } from "./escrow-fee.js";
+const ARTIFACT_KEY = "KCC20FeeEscrowV1.placeholder.json";
+// SHA-256 of JSON.stringify(JSON.parse(the packaged artifact)). This pins the
+// ABI and runtime-state layout as well as both copies of the compiled script.
+const ARTIFACT_CANONICAL_SHA256 = "2ff79d6e8ca7176d6346ab7523c72b789f7238865cd9d3b056c83a8af1b5b2cd";
+const STATE_START = 1;
+const STATE_LENGTH = 362;
+const ZERO = "00".repeat(32);
+const FIELDS = [
+    ["role", "int"], ["token", "bytes32"], ["market", "bytes32"],
+    ["policy", "bytes32"], ["protocol_account", "bytes32"],
+    ["creator_account", "bytes32"], ["protocol_amount", "int"],
+    ["creator_amount", "int"], ["owner", "bytes32"],
+    ["owner_scheme", "byte"], ["guard_template", "bytes32"],
+    ["guard_prefix", "int"], ["guard_suffix", "int"],
+    ["action_hash", "bytes32"], ["self_template", "bytes32"],
+    ["self_prefix", "int"], ["self_suffix", "int"],
+];
+function hex32(value, name) {
+    if (typeof value !== "string" || !/^[0-9a-f]{64}$/i.test(value))
+        throw new Error(`${name} must be 32-byte hex`);
+    return value.toLowerCase();
+}
+function natural(value, name) {
+    if (typeof value !== "string" || !/^(0|[1-9]\d*)$/.test(value))
+        throw new Error(`${name} must be a canonical decimal string`);
+    const result = BigInt(value);
+    if (result > KCC20_ESCROW_MAX_INT)
+        throw new Error(`${name} exceeds the contract range`);
+    return result;
+}
+function bytes(value, name) {
+    const text = hex32(value, name);
+    return Uint8Array.from(text.match(/../g).map(part => Number.parseInt(part, 16)));
+}
+function encodeState(state) {
+    const encoded = [];
+    for (const [name, kind] of FIELDS) {
+        let field;
+        if (kind === "bytes32")
+            field = bytes(state[name], name);
+        else if (kind === "byte") {
+            const value = state[name];
+            if (!Number.isInteger(value) || value < 0 || value > 255)
+                throw new Error(`${name} must be a byte`);
+            field = Uint8Array.of(value);
+        }
+        else {
+            const value = natural(state[name], name);
+            field = new Uint8Array(8);
+            new DataView(field.buffer).setBigUint64(0, value, true);
+        }
+        encoded.push(field.length, ...field);
+    }
+    if (encoded.length !== STATE_LENGTH)
+        throw new Error("fee receipt state width mismatch");
+    return Uint8Array.from(encoded);
+}
+/** Render an escrow state using only the packaged, pinned v1 program. */
+export function buildKcc20FeeEscrowScript(artifactInput, state) {
+    const artifactHash = Array.from(sha256(new TextEncoder().encode(JSON.stringify(artifactInput))), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (artifactHash !== ARTIFACT_CANONICAL_SHA256)
+        throw new Error("fee escrow artifact metadata mismatch");
+    const artifact = normalizeSilverScriptArtifact(artifactInput);
+    assertKcc20ArtifactScriptHash(ARTIFACT_KEY, artifact);
+    if (artifact.contract_name !== "KCC20FeeEscrowV1" ||
+        artifact.state_layout?.start !== STATE_START || artifact.state_layout?.len !== STATE_LENGTH) {
+        throw new Error("unsupported fee escrow artifact layout");
+    }
+    const base = Uint8Array.from(artifact.script);
+    const prefix = base.slice(0, STATE_START);
+    const suffix = base.slice(STATE_START + STATE_LENGTH);
+    const hash = Array.from(templateHash(prefix, suffix), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (hex32(state.self_template, "self_template") !== hash ||
+        natural(state.self_prefix, "self_prefix") !== BigInt(prefix.length) ||
+        natural(state.self_suffix, "self_suffix") !== BigInt(suffix.length)) {
+        throw new Error("fee escrow self-template mismatch");
+    }
+    const redeemScript = new Uint8Array(prefix.length + STATE_LENGTH + suffix.length);
+    redeemScript.set(prefix);
+    redeemScript.set(encodeState(state), prefix.length);
+    redeemScript.set(suffix, prefix.length + STATE_LENGTH);
+    const scriptHash = Array.from(blake2b(redeemScript, { dkLen: 32 }), byte => byte.toString(16).padStart(2, "0")).join("");
+    return {
+        redeemScript,
+        scriptHash,
+        scriptPublicKey: { version: 0, scriptHex: `aa20${scriptHash}87` },
+        escrowTemplate: { hash, prefixLength: prefix.length, suffixLength: suffix.length },
+    };
+}
+/**
+ * Check a receipt hint against the pinned program and a fresh node UTXO.
+ * The caller must fetch `live` from a qualified canonical node, authenticate
+ * the market root/policy, and refresh the UTXO again before signing.
+ */
+export function verifyKcc20FeeReceiptForClaim(input) {
+    const artifactHash = Array.from(sha256(new TextEncoder().encode(JSON.stringify(input.artifact))), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (artifactHash !== ARTIFACT_CANONICAL_SHA256)
+        throw new Error("fee receipt artifact metadata mismatch");
+    const artifact = normalizeSilverScriptArtifact(input.artifact);
+    assertKcc20ArtifactScriptHash(ARTIFACT_KEY, artifact);
+    if (artifact.contract_name !== "KCC20FeeEscrowV1" ||
+        artifact.state_layout?.start !== STATE_START || artifact.state_layout?.len !== STATE_LENGTH) {
+        throw new Error("unsupported fee receipt artifact layout");
+    }
+    const base = Uint8Array.from(artifact.script);
+    const prefix = base.slice(0, STATE_START);
+    const suffix = base.slice(STATE_START + STATE_LENGTH);
+    const state = input.indexed.state;
+    if (!state || Array.isArray(state) || typeof state !== "object")
+        throw new Error("missing indexed fee receipt state");
+    const expected = input.expected;
+    const tokenId = hex32(expected.tokenId, "expected token");
+    const marketId = hex32(expected.marketId, "expected market");
+    const policyId = hex32(expected.policyId, "expected policy");
+    const protocolAccountId = hex32(expected.protocolAccountId, "expected protocol account");
+    const creatorAccountId = hex32(expected.creatorAccountId, "expected creator account");
+    if ([tokenId, marketId, policyId, protocolAccountId].includes(ZERO) ||
+        protocolAccountId === creatorAccountId)
+        throw new Error("invalid fee receipt identity");
+    for (const [name, value] of [
+        ["token", tokenId], ["market", marketId], ["policy", policyId],
+        ["protocol_account", protocolAccountId], ["creator_account", creatorAccountId],
+    ]) {
+        if (hex32(state[name], name) !== hex32(value, `expected ${name}`))
+            throw new Error(`fee receipt ${name} mismatch`);
+    }
+    if (state.role !== "0" || state.roleName !== "receipt" || state.owner_scheme !== 0 ||
+        state.owner !== ZERO || state.guard_template !== ZERO ||
+        state.guard_prefix !== "0" || state.guard_suffix !== "0") {
+        throw new Error("invalid fee receipt role or owner state");
+    }
+    const selfHash = Array.from(templateHash(prefix, suffix), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (state.self_template !== selfHash || state.self_prefix !== String(prefix.length) ||
+        state.self_suffix !== String(suffix.length)) {
+        throw new Error("fee receipt self-template mismatch");
+    }
+    const protocol = natural(state.protocol_amount, "protocol_amount");
+    const creator = natural(state.creator_amount, "creator_amount");
+    const total = protocol + creator;
+    if (total === 0n || total > KCC20_ESCROW_MAX_INT ||
+        (protocol > 0n && protocol < KCC20_ESCROW_MIN_FEE_SOMPI) ||
+        (creator > 0n && creator < KCC20_ESCROW_MIN_FEE_SOMPI) ||
+        (creatorAccountId === ZERO && creator !== 0n)) {
+        throw new Error("invalid fee receipt entitlements");
+    }
+    if (input.indexed.status !== "active" || input.indexed.spentByTxidHex)
+        throw new Error("fee receipt is not active");
+    const txid = hex32(input.indexed.txidHex, "indexed txid");
+    if (!Number.isInteger(input.indexed.vout) || input.indexed.vout < 0 || input.indexed.vout > 0xffffffff ||
+        txid !== hex32(input.live.outpoint.transactionId, "live txid") || input.indexed.vout !== input.live.outpoint.index) {
+        throw new Error("fee receipt outpoint mismatch");
+    }
+    if (hex32(input.indexed.covenantIdHex, "indexed covenant") !== hex32(expected.marketId, "expected market") ||
+        hex32(input.live.covenantIdHex, "live covenant") !== hex32(expected.marketId, "expected market")) {
+        throw new Error("fee receipt covenant lineage mismatch");
+    }
+    if (natural(input.indexed.amountSompiExact, "indexed amount") !== total || input.live.amountSompi !== total) {
+        throw new Error("fee receipt amount mismatch");
+    }
+    const stateBytes = encodeState(state);
+    const redeemScript = new Uint8Array(prefix.length + stateBytes.length + suffix.length);
+    redeemScript.set(prefix);
+    redeemScript.set(stateBytes, prefix.length);
+    redeemScript.set(suffix, prefix.length + stateBytes.length);
+    const scriptHash = Array.from(blake2b(redeemScript, { dkLen: 32 }), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (hex32(input.indexed.scriptHashHex, "indexed script hash") !== scriptHash ||
+        input.live.scriptPublicKey.version !== 0 ||
+        input.live.scriptPublicKey.scriptHex.toLowerCase() !== `aa20${scriptHash}87`) {
+        throw new Error("fee receipt script hash mismatch");
+    }
+    return {
+        receipt: {
+            outpoint: { transactionId: txid, index: input.indexed.vout },
+            tokenId, marketId, policyId, protocolAccountId, creatorAccountId,
+            valueSompi: total, protocolSompi: protocol, creatorSompi: creator,
+        },
+        redeemScript,
+        escrowTemplate: { hash: selfHash, prefixLength: prefix.length, suffixLength: suffix.length },
+    };
+}
+/** Authenticate a fee-account hint against the pinned escrow artifact and a fresh node UTXO. */
+export function verifyKcc20FeeAccountForClaim(input) {
+    return verifyFeeAccount(input, false);
+}
+/** Verify an unbound account before its one-time market binding. */
+export function verifyKcc20UnboundFeeAccountForBinding(input) {
+    return verifyFeeAccount({
+        ...input,
+        expected: { ...input.expected, marketId: ZERO, policyId: ZERO },
+    }, true);
+}
+function verifyFeeAccount(input, requireUnbound) {
+    const artifactHash = Array.from(sha256(new TextEncoder().encode(JSON.stringify(input.artifact))), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (artifactHash !== ARTIFACT_CANONICAL_SHA256)
+        throw new Error("fee account artifact metadata mismatch");
+    const artifact = normalizeSilverScriptArtifact(input.artifact);
+    assertKcc20ArtifactScriptHash(ARTIFACT_KEY, artifact);
+    if (artifact.contract_name !== "KCC20FeeEscrowV1" ||
+        artifact.state_layout?.start !== STATE_START || artifact.state_layout?.len !== STATE_LENGTH) {
+        throw new Error("unsupported fee account artifact layout");
+    }
+    const base = Uint8Array.from(artifact.script);
+    const prefix = base.slice(0, STATE_START);
+    const suffix = base.slice(STATE_START + STATE_LENGTH);
+    const state = input.indexed.state;
+    if (!state || Array.isArray(state) || typeof state !== "object")
+        throw new Error("missing indexed fee account state");
+    const tokenId = hex32(input.expected.tokenId, "expected token");
+    const marketId = hex32(input.expected.marketId, "expected market");
+    const policyId = hex32(input.expected.policyId, "expected policy");
+    const accountId = hex32(input.expected.accountId, "expected account");
+    if (tokenId === ZERO || accountId === ZERO ||
+        (requireUnbound ? (marketId !== ZERO || policyId !== ZERO) : (marketId === ZERO || policyId === ZERO))) {
+        throw new Error("invalid fee account identity");
+    }
+    for (const [name, expected] of [["token", tokenId], ["market", marketId], ["policy", policyId]]) {
+        if (hex32(state[name], name) !== expected)
+            throw new Error(`fee account ${name} mismatch`);
+    }
+    if (state.role !== "1" || state.roleName !== "account" ||
+        hex32(state.protocol_account, "protocol_account") !== ZERO ||
+        hex32(state.creator_account, "creator_account") !== ZERO ||
+        natural(state.protocol_amount, "protocol_amount") !== 0n ||
+        natural(state.creator_amount, "creator_amount") !== 0n ||
+        hex32(state.owner, "owner") === ZERO ||
+        !Number.isInteger(state.owner_scheme) || state.owner_scheme < 0 ||
+        state.owner_scheme > 4) {
+        throw new Error("invalid fee account role or owner state");
+    }
+    const guard = hex32(state.guard_template, "guard_template");
+    const guardPrefix = natural(state.guard_prefix, "guard_prefix");
+    const guardSuffix = natural(state.guard_suffix, "guard_suffix");
+    const scheme = state.owner_scheme;
+    if ((scheme <= 2 && (guard !== ZERO || guardPrefix !== 0n || guardSuffix !== 0n)) ||
+        (scheme === 3 && (guard === ZERO || guardPrefix !== 0n || guardSuffix !== 0n)) ||
+        (scheme === 4 && (guard === ZERO || guardPrefix === 0n || guardSuffix === 0n))) {
+        throw new Error("invalid fee account guard state");
+    }
+    hex32(state.action_hash, "action_hash");
+    if (requireUnbound && (scheme !== 0 || state.action_hash !== ZERO)) {
+        throw new Error("unbound fee account must have its initial owner and action state");
+    }
+    const selfHash = Array.from(templateHash(prefix, suffix), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (hex32(state.self_template, "self_template") !== selfHash ||
+        natural(state.self_prefix, "self_prefix") !== BigInt(prefix.length) ||
+        natural(state.self_suffix, "self_suffix") !== BigInt(suffix.length)) {
+        throw new Error("fee account self-template mismatch");
+    }
+    if (input.indexed.status !== "active" || input.indexed.spentByTxidHex)
+        throw new Error("fee account is not active");
+    const txid = hex32(input.indexed.txidHex, "indexed txid");
+    if (!Number.isInteger(input.indexed.vout) || input.indexed.vout < 0 || input.indexed.vout > 0xffffffff ||
+        txid !== hex32(input.live.outpoint.transactionId, "live txid") || input.indexed.vout !== input.live.outpoint.index ||
+        hex32(input.indexed.covenantIdHex, "indexed covenant") !== accountId ||
+        hex32(input.live.covenantIdHex, "live covenant") !== accountId) {
+        throw new Error("fee account outpoint or lineage mismatch");
+    }
+    const principal = natural(input.indexed.amountSompiExact, "account principal");
+    if (principal === 0n || input.live.amountSompi !== principal)
+        throw new Error("fee account principal mismatch");
+    const stateBytes = encodeState(state);
+    const redeemScript = new Uint8Array(prefix.length + stateBytes.length + suffix.length);
+    redeemScript.set(prefix);
+    redeemScript.set(stateBytes, prefix.length);
+    redeemScript.set(suffix, prefix.length + stateBytes.length);
+    const scriptHash = Array.from(blake2b(redeemScript, { dkLen: 32 }), byte => byte.toString(16).padStart(2, "0")).join("");
+    if (hex32(input.indexed.scriptHashHex, "indexed script hash") !== scriptHash ||
+        input.live.scriptPublicKey.version !== 0 ||
+        input.live.scriptPublicKey.scriptHex.toLowerCase() !== `aa20${scriptHash}87`) {
+        throw new Error("fee account script hash mismatch");
+    }
+    return {
+        account: {
+            outpoint: { transactionId: txid, index: input.indexed.vout },
+            covenantId: accountId, principalSompi: principal,
+            state: state,
+        },
+        redeemScript,
+        escrowTemplate: { hash: selfHash, prefixLength: prefix.length, suffixLength: suffix.length },
+    };
+}
+//# sourceMappingURL=escrow-receipt.js.map

package/dist/escrow-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow-receipt.js","sourceRoot":"","sources":["../src/escrow-receipt.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -21,6 +21,9 @@ export * from "./trade-fee.js";
 export * from "./escrow-fee.js";
 export * from "./escrow-policy.js";
 export * from "./escrow-group.js";
+export * from "./escrow-receipt.js";
+export * from "./escrow-claim-plan.js";
+export * from "./escrow-account-setup.js";
 export * from "./trading-operation.js";
 export * from "./protocol.js";
 export * from "./runtime.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,oBAAoB,MAAM,uCAAuC,CAAC;AAC9E,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,oBAAoB,MAAM,uCAAuC,CAAC;AAC9E,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -21,6 +21,9 @@ export * from "./trade-fee.js";
 export * from "./escrow-fee.js";
 export * from "./escrow-policy.js";
 export * from "./escrow-group.js";
+export * from "./escrow-receipt.js";
+export * from "./escrow-claim-plan.js";
+export * from "./escrow-account-setup.js";
 export * from "./trading-operation.js";
 export * from "./protocol.js";
 export * from "./runtime.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,oBAAoB,MAAM,uCAAuC,CAAC;AAC9E,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,KAAK,QAAQ,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,oBAAoB,MAAM,uCAAuC,CAAC;AAC9E,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/operations.d.ts

@@ -1,4 +1,4 @@
-export declare const KCC20_BUILDER_KEYS: readonly ["kcc20.deploy-token", "kcc20.mint", "kcc20.set-public-mint-active", "kcc20.transfer", "kcc20.consolidate-holders", "kcc20.reveal-token", "kcc20wrapper.deploy-market", "kcc20wrapper.wrap", "kcc20wrapper.unwrap", "kcc20orderbook.create-bid", "kcc20orderbook.create-ask", "kcc20orderbook.fill-ask", "kcc20orderbook.fill-bid", "kcc20orderbook.sweep-asks", "kcc20orderbook.sweep-bids", "kcc20orderbook.consolidate-holders", "kcc20orderbook.cancel-ask", "kcc20orderbook.cancel-bid", "fee-ticket.deploy-root", "fee-ticket.update-denomination", "fee-ticket.create-from-utility-burn", "fee-ticket.burn", "fee-ticket.transfer", "kcc20-snapshot.deploy-bootstrap", "kcc20-snapshot.deploy-controller", "kcc20-snapshot.start", "kcc20-snapshot.claim"];
+export declare const KCC20_BUILDER_KEYS: readonly ["kcc20.deploy-token", "kcc20.mint", "kcc20.set-public-mint-active", "kcc20.transfer", "kcc20.consolidate-holders", "kcc20.reveal-token", "kcc20wrapper.deploy-market", "kcc20wrapper.wrap", "kcc20wrapper.unwrap", "kcc20orderbook.create-bid", "kcc20orderbook.create-ask", "kcc20orderbook.fill-ask", "kcc20orderbook.fill-bid", "kcc20orderbook.sweep-asks", "kcc20orderbook.sweep-bids", "kcc20orderbook.consolidate-holders", "kcc20orderbook.cancel-ask", "kcc20orderbook.cancel-bid", "fee-ticket.deploy-root", "fee-ticket.update-denomination", "fee-ticket.create-from-utility-burn", "fee-ticket.burn", "fee-ticket.transfer", "kcc20fee.create-account", "kcc20fee.bind-account", "kcc20-snapshot.deploy-bootstrap", "kcc20-snapshot.deploy-controller", "kcc20-snapshot.start", "kcc20-snapshot.claim"];
 export type Kcc20BuilderKey = (typeof KCC20_BUILDER_KEYS)[number];
 export declare function isKcc20BuilderKey(value: string): value is Kcc20BuilderKey;
 export declare const BACKEND_ONLY_BUILDER_KEYS: readonly ["kcc20orderbook.matcher-settle-crossed"];

package/dist/operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,4uBA4BrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED,eAAO,MAAM,yBAAyB,oDAE5B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAKhC"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,gyBA8BrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED,eAAO,MAAM,yBAAyB,oDAE5B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAKhC"}

package/dist/operations.js

@@ -22,6 +22,8 @@ export const KCC20_BUILDER_KEYS = [
     "fee-ticket.create-from-utility-burn",
     "fee-ticket.burn",
     "fee-ticket.transfer",
+    "kcc20fee.create-account",
+    "kcc20fee.bind-account",
     "kcc20-snapshot.deploy-bootstrap",
     "kcc20-snapshot.deploy-controller",
     "kcc20-snapshot.start",

package/dist/operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB;IACpB,YAAY;IACZ,8BAA8B;IAC9B,gBAAgB;IAChB,2BAA2B;IAC3B,oBAAoB;IACpB,4BAA4B;IAC5B,mBAAmB;IACnB,qBAAqB;IACrB,2BAA2B;IAC3B,2BAA2B;IAC3B,yBAAyB;IACzB,yBAAyB;IACzB,2BAA2B;IAC3B,2BAA2B;IAC3B,oCAAoC;IACpC,2BAA2B;IAC3B,2BAA2B;IAC3B,wBAAwB;IACxB,gCAAgC;IAChC,qCAAqC;IACrC,iBAAiB;IACjB,qBAAqB;IACrB,iCAAiC;IACjC,kCAAkC;IAClC,sBAAsB;IACtB,sBAAsB;CACd,CAAC;AAIX,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,uCAAuC;CAC/B,CAAC;AAIX,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,yBAA+C,CAAC,QAAQ,CAAC,KAAK,CAAC,CACjE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB;IACpB,YAAY;IACZ,8BAA8B;IAC9B,gBAAgB;IAChB,2BAA2B;IAC3B,oBAAoB;IACpB,4BAA4B;IAC5B,mBAAmB;IACnB,qBAAqB;IACrB,2BAA2B;IAC3B,2BAA2B;IAC3B,yBAAyB;IACzB,yBAAyB;IACzB,2BAA2B;IAC3B,2BAA2B;IAC3B,oCAAoC;IACpC,2BAA2B;IAC3B,2BAA2B;IAC3B,wBAAwB;IACxB,gCAAgC;IAChC,qCAAqC;IACrC,iBAAiB;IACjB,qBAAqB;IACrB,yBAAyB;IACzB,uBAAuB;IACvB,iCAAiC;IACjC,kCAAkC;IAClC,sBAAsB;IACtB,sBAAsB;CACd,CAAC;AAIX,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,uCAAuC;CAC/B,CAAC;AAIX,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,yBAA+C,CAAC,QAAQ,CAAC,KAAK,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/docs/COMPATIBILITY.json

@@ -1,6 +1,6 @@
 {
   "schema": "kcc20-example-compatibility/v1",
-  "packageVersion": "0.8.0-fee.1",
+  "packageVersion": "0.8.0-fee.3",
   "contractsRepository": "https://github.com/KASPACOM/kaspa-covenants",
   "contractsCommit": "5deb1769e69142595576ef7c573af9f433a48a3c",
   "compiler": {

package/docs/escrow-fees.md

@@ -1,8 +1,33 @@
 # Experimental fee escrow primitives
 
-These exports support the new DEV fee-market contracts. Existing transaction
-construction still uses the legacy fee version. These functions do not build,
-authorize or submit escrow spends, and this change does not publish a package.
+These exports support the new DEV fee-market contracts. Existing trading
+transactions still use the legacy fee version. New fee-market creation remains
+disabled, and this change does not publish a package.
+
+## Fee account setup
+
+`kcc20fee.create-account` builds a version 1 PSKT with one unbound fee-account
+genesis output and a separate wallet change output. The caller supplies the
+native token ID and account principal in sompi. The connected wallet's Schnorr
+public key controls the account. The builder pins the escrow artifact, checks
+the key, computes the account covenant ID, and checks the signed transaction's
+fee and mass before returning the PSKT. The wallet signs the funding input.
+
+The creation result includes `metadata.accountGenesisHint`. Save it with the
+broadcast result and add the accepted transaction ID as `txidHex`. An unspent
+P2SH genesis output does not reveal its account state to the indexer.
+
+`kcc20fee.bind-account` accepts that saved `accountGenesisHint`, or an
+equivalent active account record, plus the token, account, market and policy
+IDs. It fetches the current account UTXO from the node and checks its script,
+lineage, outpoint and principal against the pinned artifact. The wallet signs
+the account input and a separate funding input. The bound output keeps the
+same account ID and exact principal. Binding is a one-time operation; later
+authority changes use the contract's rotation path.
+
+These operations prepare wallet-signable transactions. They do not broadcast
+or establish funded TN10 execution. Account creation and binding are only the
+first setup steps; trading, claims and rotation still need signed builders.
 
 `calculateKcc20EscrowFees` implements the fixed 1% protocol fee and optional
 0–5% creator fee. Each nonzero share has a 0.5 KAS minimum, applied per fill.
@@ -30,6 +55,25 @@ claim and retained amounts. This does not establish that the receipts exist,
 are unspent or have authenticated scripts. Construction must revalidate all
 inputs against current chain state and the approved artifacts.
 
+`verifyKcc20FeeReceiptForClaim` reconstructs an indexed receipt from the
+pinned escrow artifact and compares its exact script, covenant lineage,
+outpoint and value with a UTXO supplied from the canonical node. The caller
+must authenticate the market policy, obtain a fresh node result and check the
+UTXO again immediately before signing. This helper does not build or authorize
+a claim.
+
+`verifyKcc20FeeAccountForClaim` makes the equivalent check for the fee account,
+including its owner scheme, guard, principal and exact script. Pass the pinned
+receipt template to the claim planner and preserve the selected receipts' order
+as the transaction's covenant input order. Both helpers trust the caller to
+obtain canonical fresh UTXOs; they cannot establish source quality themselves.
+
+`planKcc20FeeClaimTransition` calculates the claimant payout, unchanged
+account principal, account continuation and any receipt left for the other
+party. Its inputs still require live UTXO checks and account authorization.
+The plan does not select funding, sign or estimate transaction mass. It rejects
+an account whose program template differs from the verified receipt template.
+
 `encodeKcc20EscrowPolicy` and `decodeKcc20EscrowPolicy` implement the fixed
 361-byte role policy, with receipt, root, holder, ask, bid and FeeTicket
 template tuples in that order. They reject unsupported versions, noncanonical

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaspacom/kcc20-tx-builder",
-  "version": "0.8.0-fee.1",
+  "version": "0.8.0-fee.3",
   "description": "Runtime-independent KCC20 covenant transaction and PSKT construction primitives.",
   "license": "Apache-2.0",
   "author": "KaspaCom",
@@ -88,8 +88,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/write-cjs-package.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test:escrow-fee": "npm run build && node --test test/escrow-fee.mjs test/escrow-policy.mjs test/escrow-group.mjs",
-    "test": "npm run typecheck && npm run build && node test/smoke.mjs && node test/cjs-smoke.cjs && node test/snapshot-plan.mjs && node test/token-profiles.mjs && node test/profile-transfer.mjs && node --test test/mint-availability-limit.mjs test/consolidation-profile.mjs test/consolidation-transaction.mjs test/escrow-fee.mjs test/escrow-policy.mjs test/escrow-group.mjs && node test/pinned-funding.mjs",
+    "test:escrow-fee": "npm run build && node --test test/escrow-fee.mjs test/escrow-policy.mjs test/escrow-group.mjs test/escrow-receipt.mjs test/escrow-claim-plan.mjs test/escrow-account-setup.mjs test/escrow-account-bind-pskt.mjs",
+    "test": "npm run typecheck && npm run build && node test/smoke.mjs && node test/cjs-smoke.cjs && node test/snapshot-plan.mjs && node test/token-profiles.mjs && node test/profile-transfer.mjs && node --test test/mint-availability-limit.mjs test/consolidation-profile.mjs test/consolidation-transaction.mjs test/escrow-fee.mjs test/escrow-policy.mjs test/escrow-group.mjs test/escrow-receipt.mjs test/escrow-claim-plan.mjs test/escrow-account-setup.mjs test/escrow-account-bind-pskt.mjs && node test/pinned-funding.mjs",
     "prepack": "npm test",
     "test:examples": "npm run verify:compatibility && node scripts/test-examples.mjs --browser",
     "verify:compatibility": "node scripts/verify-compatibility.mjs",