@easy1staking/cip113-sdk-ts 0.1.0

package/dist/core/evo-utils.js

@@ -0,0 +1,401 @@
+/**
+ * Shared Evolution SDK utility functions.
+ *
+ * These are used across the SDK to build scripts, addresses, datums, and
+ * perform common conversions. All use Evolution SDK types directly.
+ */
+import { Data, Bytes, ScriptHash as EvoScriptHash, Script, UPLC, Address as EvoAddress, AddressEras, BaseAddress, EnterpriseAddress, RewardAccount, Assets, Credential, InlineDatum, KeyHash, TransactionHash, Transaction, } from "@evolution-sdk/evolution";
+const PlutusV3 = Script.Script.members[3];
+import * as Label from "@evolution-sdk/evolution/assets/Label";
+// ---------------------------------------------------------------------------
+// Script building
+// ---------------------------------------------------------------------------
+/**
+ * Build a PlutusV3 script object from compiled code hex.
+ *
+ * Handles CBOR encoding levels: if "double" (from applyParamsToScript),
+ * strips outer CBOR header to get single-CBOR for PlutusV3.
+ */
+export function buildEvoScript(compiledCode) {
+    const level = UPLC.getCborEncodingLevel(compiledCode);
+    if (level === "double") {
+        const raw = Bytes.fromHex(compiledCode);
+        const additionalInfo = raw[0] & 0x1f;
+        const headerLen = additionalInfo < 24 ? 1 : additionalInfo === 24 ? 2 : additionalInfo === 25 ? 3 : 5;
+        const innerBytes = raw.slice(headerLen);
+        return new PlutusV3({ bytes: innerBytes });
+    }
+    return new PlutusV3({ bytes: Bytes.fromHex(compiledCode) });
+}
+/**
+ * Parameterize a script and compute its hash.
+ * Returns a PlutusScript with compiledCode and hash.
+ */
+export function parameterizeScript(compiledCode, params) {
+    const parameterized = UPLC.applyParamsToScript(compiledCode, params);
+    const script = buildEvoScript(parameterized);
+    const hash = EvoScriptHash.toHex(EvoScriptHash.fromScript(script));
+    return { type: "PlutusV3", compiledCode: parameterized, hash };
+}
+/**
+ * Compute script hash from compiled code.
+ */
+export function computeScriptHash(compiledCode) {
+    const script = buildEvoScript(compiledCode);
+    return EvoScriptHash.toHex(EvoScriptHash.fromScript(script));
+}
+// ---------------------------------------------------------------------------
+// Address building
+// ---------------------------------------------------------------------------
+/**
+ * Build an enterprise (script-only) address from a script hash.
+ */
+export function scriptAddress(networkId, scriptHash) {
+    const cred = new EvoScriptHash.ScriptHash({ hash: Bytes.fromHex(scriptHash) });
+    const addr = new EnterpriseAddress.EnterpriseAddress({ networkId, paymentCredential: cred });
+    return AddressEras.toBech32(addr);
+}
+/**
+ * Build a reward (staking) address from a script hash.
+ */
+export function rewardAddress(networkId, scriptHash) {
+    const cred = new EvoScriptHash.ScriptHash({ hash: Bytes.fromHex(scriptHash) });
+    const addr = new RewardAccount.RewardAccount({ networkId, stakeCredential: cred });
+    return AddressEras.toBech32(addr);
+}
+/**
+ * Build a base address with script payment credential and user's staking credential.
+ */
+export function baseAddress(networkId, scriptHash, userAddress) {
+    const stakingHash = stakingCredentialHash(userAddress);
+    const addr = new BaseAddress.BaseAddress({
+        networkId,
+        paymentCredential: new EvoScriptHash.ScriptHash({ hash: Bytes.fromHex(scriptHash) }),
+        stakeCredential: new KeyHash.KeyHash({ hash: Bytes.fromHex(stakingHash) }),
+    });
+    return AddressEras.toBech32(addr);
+}
+/**
+ * Extract the staking credential hash from a bech32 address.
+ */
+export function stakingCredentialHash(address) {
+    const evoAddr = EvoAddress.fromBech32(address);
+    const ba = BaseAddress.fromHex(EvoAddress.toHex(evoAddr));
+    return Bytes.toHex(ba.stakeCredential.hash);
+}
+/**
+ * Extract the payment credential hash from a bech32 address.
+ */
+export function paymentCredentialHash(address) {
+    const evoAddr = EvoAddress.fromBech32(address);
+    const ba = BaseAddress.fromHex(EvoAddress.toHex(evoAddr));
+    return Bytes.toHex(ba.paymentCredential.hash);
+}
+// ---------------------------------------------------------------------------
+// Data construction helpers (Cardano-specific)
+// ---------------------------------------------------------------------------
+/** OutputReference: Constr(0, [txHash, outputIndex]) */
+export function outputReference(ref) {
+    return Data.constr(0n, [
+        Data.bytearray(ref.txHash),
+        Data.int(BigInt(ref.outputIndex)),
+    ]);
+}
+/** Script credential: Constr(1, [scriptHash]) */
+export function scriptCredential(hash) {
+    return Data.constr(1n, [Data.bytearray(hash)]);
+}
+/** Verification key credential: Constr(0, [keyHash]) */
+export function keyCredential(hash) {
+    return Data.constr(0n, [Data.bytearray(hash)]);
+}
+/** Void / unit: Constr(0, []) */
+export function voidData() {
+    return Data.constr(0n, []);
+}
+// ---------------------------------------------------------------------------
+// Datum parsing (from on-chain Evolution SDK UTxO datums)
+// ---------------------------------------------------------------------------
+/**
+ * Extract a bytes field from a Constr datum at a given index.
+ * Works with Evolution SDK's Data.Constr format.
+ */
+export function extractConstrBytesField(datum, fieldIndex) {
+    if (!datum || typeof datum !== "object")
+        return undefined;
+    // Evolution SDK Constr: check with Data.isConstr
+    if (Data.isConstr(datum)) {
+        const constr = datum;
+        const field = constr.fields[fieldIndex];
+        if (field == null)
+            return undefined;
+        if (Data.isBytes(field)) {
+            return Bytes.toHex(field);
+        }
+        return undefined;
+    }
+    return undefined;
+}
+/**
+ * Extract a credential (type + hash) from a constr datum field.
+ * Credential is Constr(0|1, [bytes]) — 0 = key, 1 = script.
+ */
+export function extractCredentialField(datum, fieldIndex) {
+    if (!datum || typeof datum !== "object")
+        return undefined;
+    if (Data.isConstr(datum)) {
+        const constr = datum;
+        const field = constr.fields[fieldIndex];
+        if (!field || !Data.isConstr(field))
+            return undefined;
+        const credConstr = field;
+        const type = credConstr.index === 0n ? "key" : "script";
+        const inner = credConstr.fields[0];
+        if (!inner)
+            return { type, hash: "" };
+        if (Data.isBytes(inner)) {
+            return { type, hash: Bytes.toHex(inner) };
+        }
+        return { type, hash: "" };
+    }
+    return undefined;
+}
+/** Build a RegistryNode datum */
+export function registryNodeDatum(node) {
+    const credToData = (cred) => cred.type === "script"
+        ? scriptCredential(cred.hash)
+        : keyCredential(cred.hash);
+    return Data.constr(0n, [
+        Data.bytearray(node.key),
+        Data.bytearray(node.next),
+        credToData(node.transferLogicScript),
+        credToData(node.thirdPartyTransferLogicScript),
+        Data.bytearray(node.globalStateCs),
+    ]);
+}
+/** Build a BlacklistNode datum */
+export function blacklistNodeDatum(key, next) {
+    return Data.constr(0n, [Data.bytearray(key), Data.bytearray(next)]);
+}
+// ---------------------------------------------------------------------------
+// Redeemer builders (CIP-113 validators)
+// ---------------------------------------------------------------------------
+/**
+ * SmartTokenMintingAction redeemer for first mint (OutputIndex).
+ */
+export function issuanceRedeemerFirstMint(mintingLogicHash, registryOutputIndex) {
+    return Data.constr(0n, [
+        scriptCredential(mintingLogicHash),
+        Data.constr(1n, [Data.int(BigInt(registryOutputIndex))]),
+    ]);
+}
+/**
+ * SmartTokenMintingAction redeemer for subsequent mint/burn (RefInput).
+ */
+export function issuanceRedeemerRefInput(mintingLogicHash, registryRefInputIndex) {
+    return Data.constr(0n, [
+        scriptCredential(mintingLogicHash),
+        Data.constr(0n, [Data.int(BigInt(registryRefInputIndex))]),
+    ]);
+}
+/** Build a TransferAct redeemer for PLGlobal. */
+export function transferActRedeemer(proofs) {
+    return Data.constr(0n, [
+        Data.list(proofs.map((p) => p.type === "exists"
+            ? Data.constr(0n, [Data.int(BigInt(p.nodeIdx))])
+            : Data.constr(1n, [Data.int(BigInt(p.nodeIdx))]))),
+    ]);
+}
+/** Build a ThirdPartyAct redeemer for PLGlobal. */
+export function thirdPartyActRedeemer(registryNodeIdx, outputsStartIdx) {
+    return Data.constr(1n, [
+        Data.int(BigInt(registryNodeIdx)),
+        Data.int(BigInt(outputsStartIdx)),
+    ]);
+}
+/** RegistryInsert redeemer */
+export function registryInsertRedeemer(key, hashedParam) {
+    return Data.constr(1n, [Data.bytearray(key), Data.bytearray(hashedParam)]);
+}
+/** Blacklist init (constructor 0) */
+export function blacklistInitRedeemer() {
+    return Data.constr(0n, []);
+}
+/** Blacklist add (constructor 1) */
+export function blacklistAddRedeemer(stakingPkh) {
+    return Data.constr(1n, [Data.bytearray(stakingPkh)]);
+}
+/** Blacklist remove (constructor 2) */
+export function blacklistRemoveRedeemer(stakingPkh) {
+    return Data.constr(2n, [Data.bytearray(stakingPkh)]);
+}
+// ---------------------------------------------------------------------------
+// Asset helpers
+// ---------------------------------------------------------------------------
+/** Build an Assets object with a single native token unit + min lovelace */
+export function singleTokenAssets(policyId, assetName, qty) {
+    let assets = Assets.fromLovelace(0n);
+    assets = Assets.addByHex(assets, policyId, assetName, qty);
+    return Assets.withoutLovelace(assets);
+}
+/** Build mint assets map from unit -> qty entries (Evolution SDK format) */
+export function mintAssetsFromMap(entries) {
+    let assets = Assets.fromLovelace(0n);
+    for (const [unit, qty] of entries) {
+        const policyId = unit.slice(0, 56);
+        const assetName = unit.slice(56);
+        assets = Assets.addByHex(assets, policyId, assetName, qty);
+    }
+    return Assets.withoutLovelace(assets);
+}
+/** Build output assets: lovelace + optional token map */
+export function outputAssets(lovelace, tokenMap) {
+    let assets = Assets.fromLovelace(lovelace);
+    if (tokenMap) {
+        for (const [unit, qty] of tokenMap) {
+            const policyId = unit.slice(0, 56);
+            const assetName = unit.slice(56);
+            assets = Assets.addByHex(assets, policyId, assetName, qty);
+        }
+    }
+    return assets;
+}
+// ---------------------------------------------------------------------------
+// UTxO datum extraction
+// ---------------------------------------------------------------------------
+/**
+ * Get the inline datum from a UTxO. Returns undefined if no inline datum.
+ */
+export function getInlineDatum(utxo) {
+    const datumOpt = utxo.datumOption;
+    if (datumOpt?._tag === "InlineDatum" && datumOpt.data != null) {
+        return datumOpt.data;
+    }
+    return undefined;
+}
+/**
+ * Get the UTxO's value as a check for a specific unit.
+ */
+export function utxoHasUnit(utxo, unit) {
+    try {
+        const qty = Assets.getByUnit(utxo.assets, unit);
+        return qty > 0n;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the quantity of a specific unit in a UTxO.
+ */
+export function utxoUnitQty(utxo, unit) {
+    try {
+        return Assets.getByUnit(utxo.assets, unit);
+    }
+    catch {
+        return 0n;
+    }
+}
+/**
+ * Get the lovelace amount from a UTxO.
+ */
+export function utxoLovelace(utxo) {
+    return Assets.lovelaceOf(utxo.assets);
+}
+/**
+ * Get the txHash of a UTxO as a hex string.
+ */
+export function utxoTxHash(utxo) {
+    return TransactionHash.toHex(utxo.transactionId);
+}
+/**
+ * Get the output index of a UTxO as a number.
+ */
+export function utxoOutputIndex(utxo) {
+    return Number(utxo.index);
+}
+/**
+ * Get the bech32 address of a UTxO.
+ */
+export function utxoAddress(utxo) {
+    return EvoAddress.toBech32(utxo.address);
+}
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Max next pointer for linked list sentinel (30 bytes, matches Aiken #"ff"*30) */
+export const MAX_NEXT = "ff".repeat(30);
+/** Convert a UTF-8 string to hex */
+export function stringToHex(str) {
+    return Buffer.from(str, "utf-8").toString("hex");
+}
+/** Prefix an asset name hex with a CIP-67 label (e.g., 333 → "000f4141" + assetNameHex). */
+export function labeledAssetName(label, assetNameHex) {
+    return Label.toLabel(label) + assetNameHex;
+}
+/** Strip a CIP-67 label prefix from an asset name hex, if present. Returns the stripped (unlabeled) name. */
+export function stripCIP67Label(assetNameHex) {
+    // CIP-67 labels are 4 bytes = 8 hex chars
+    if (!assetNameHex || assetNameHex.length <= 8)
+        return assetNameHex || "";
+    try {
+        const labelHex = assetNameHex.substring(0, 8);
+        // Label.fromLabel will throw/return null if not a valid CIP-67 label
+        const label = Label.fromLabel(labelHex);
+        if (label !== undefined && label !== null) {
+            return assetNameHex.substring(8);
+        }
+    }
+    catch {
+        // Not a valid CIP-67 label prefix — return as-is
+    }
+    return assetNameHex;
+}
+/** Check if an asset name hex starts with a CIP-67 label prefix. */
+export function hasCIP67Label(assetNameHex) {
+    if (!assetNameHex || assetNameHex.length <= 8)
+        return false;
+    try {
+        const labelHex = assetNameHex.substring(0, 8);
+        const label = Label.fromLabel(labelHex);
+        return label !== undefined && label !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build CIP-68 FT metadata datum: Constr(0, [metadata_map, version, extra]).
+ *
+ * Keys and text values are byte strings (standard CIP-68 convention).
+ * Matches real-world CIP-68 FT datums (e.g., FLDT token).
+ */
+export function buildCIP68FTDatum(meta) {
+    const entries = [];
+    entries.push([Data.bytearray(stringToHex("name")), Data.bytearray(stringToHex(meta.name))]);
+    if (meta.description) {
+        entries.push([Data.bytearray(stringToHex("description")), Data.bytearray(stringToHex(meta.description))]);
+    }
+    if (meta.ticker) {
+        entries.push([Data.bytearray(stringToHex("ticker")), Data.bytearray(stringToHex(meta.ticker))]);
+    }
+    if (meta.decimals !== undefined) {
+        entries.push([Data.bytearray(stringToHex("decimals")), Data.int(BigInt(meta.decimals))]);
+    }
+    if (meta.url) {
+        entries.push([Data.bytearray(stringToHex("url")), Data.bytearray(stringToHex(meta.url))]);
+    }
+    if (meta.logo) {
+        entries.push([Data.bytearray(stringToHex("logo")), Data.bytearray(stringToHex(meta.logo))]);
+    }
+    return Data.constr(0n, [
+        Data.map(entries),
+        Data.int(1n), // version
+        Data.int(1n), // extra (matches real-world CIP-68 datums)
+    ]);
+}
+// ---------------------------------------------------------------------------
+// Re-exports for convenience
+// ---------------------------------------------------------------------------
+export { Data, Bytes, Assets, Credential, InlineDatum, KeyHash, EvoAddress, EvoScriptHash, TransactionHash, Transaction, UPLC, };
+//# sourceMappingURL=evo-utils.js.map

package/dist/core/evo-utils.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Registry node lookup and reference input index computation.
+ *
+ * Uses Evolution SDK types directly — no adapter abstraction.
+ */
+import type { UTxO as EvoUTxO } from "@evolution-sdk/evolution";
+import type { PolicyId, TxInput } from "../types.js";
+/**
+ * Sort transaction inputs lexicographically by (txHash, outputIndex).
+ * This matches the Cardano ledger's canonical ordering.
+ */
+export declare function sortTxInputs<T extends TxInput>(inputs: T[]): T[];
+/**
+ * Find the index of a TxInput in a sorted list of reference inputs.
+ */
+export declare function findRefInputIndex(sortedRefInputs: TxInput[], target: TxInput): number;
+/**
+ * Find the registry node UTxO for a given token policy ID.
+ * Searches the provided UTxOs for a node whose key matches the policy.
+ */
+export declare function findRegistryNode(utxos: EvoUTxO.UTxO[], tokenPolicyId: PolicyId): EvoUTxO.UTxO | undefined;
+/**
+ * Find the covering node for a new token insertion.
+ * The covering node satisfies: node.key < tokenPolicyId < node.next
+ */
+export declare function findCoveringNode(utxos: EvoUTxO.UTxO[], tokenPolicyId: PolicyId): EvoUTxO.UTxO | undefined;
+/**
+ * Convert a UTxO to a TxInput for sorting purposes.
+ */
+export declare function utxoToTxInput(utxo: EvoUTxO.UTxO): TxInput;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAW,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAY9D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAMhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,OAAO,EAAE,EAC1B,MAAM,EAAE,OAAO,GACd,MAAM,CAUR;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,EACrB,aAAa,EAAE,QAAQ,GACtB,OAAO,CAAC,IAAI,GAAG,SAAS,CAM1B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,EACrB,aAAa,EAAE,QAAQ,GACtB,OAAO,CAAC,IAAI,GAAG,SAAS,CAS1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAKzD"}

package/dist/core/registry.js

@@ -0,0 +1,72 @@
+/**
+ * Registry node lookup and reference input index computation.
+ *
+ * Uses Evolution SDK types directly — no adapter abstraction.
+ */
+import { extractConstrBytesField, getInlineDatum, utxoTxHash, utxoOutputIndex, } from "./evo-utils.js";
+// ---------------------------------------------------------------------------
+// Transaction input sorting (matches Cardano ledger canonical order)
+// ---------------------------------------------------------------------------
+/**
+ * Sort transaction inputs lexicographically by (txHash, outputIndex).
+ * This matches the Cardano ledger's canonical ordering.
+ */
+export function sortTxInputs(inputs) {
+    return [...inputs].sort((a, b) => {
+        const hashCmp = a.txHash.localeCompare(b.txHash);
+        if (hashCmp !== 0)
+            return hashCmp;
+        return a.outputIndex - b.outputIndex;
+    });
+}
+/**
+ * Find the index of a TxInput in a sorted list of reference inputs.
+ */
+export function findRefInputIndex(sortedRefInputs, target) {
+    const idx = sortedRefInputs.findIndex((ri) => ri.txHash === target.txHash && ri.outputIndex === target.outputIndex);
+    if (idx === -1) {
+        throw new Error(`Reference input ${target.txHash}#${target.outputIndex} not found in sorted list`);
+    }
+    return idx;
+}
+// ---------------------------------------------------------------------------
+// Registry node queries
+// ---------------------------------------------------------------------------
+/**
+ * Find the registry node UTxO for a given token policy ID.
+ * Searches the provided UTxOs for a node whose key matches the policy.
+ */
+export function findRegistryNode(utxos, tokenPolicyId) {
+    return utxos.find((utxo) => {
+        const datum = getInlineDatum(utxo);
+        if (!datum)
+            return false;
+        return extractConstrBytesField(datum, 0) === tokenPolicyId;
+    });
+}
+/**
+ * Find the covering node for a new token insertion.
+ * The covering node satisfies: node.key < tokenPolicyId < node.next
+ */
+export function findCoveringNode(utxos, tokenPolicyId) {
+    return utxos.find((utxo) => {
+        const datum = getInlineDatum(utxo);
+        if (!datum)
+            return false;
+        const key = extractConstrBytesField(datum, 0);
+        const next = extractConstrBytesField(datum, 1);
+        if (key === undefined || next === undefined)
+            return false;
+        return key < tokenPolicyId && tokenPolicyId < next;
+    });
+}
+/**
+ * Convert a UTxO to a TxInput for sorting purposes.
+ */
+export function utxoToTxInput(utxo) {
+    return {
+        txHash: utxoTxHash(utxo),
+        outputIndex: utxoOutputIndex(utxo),
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,8EAA8E;AAC9E,qEAAqE;AACrE,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAoB,MAAW;IACzD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAClC,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,eAA0B,EAC1B,MAAe;IAEf,MAAM,GAAG,GAAG,eAAe,CAAC,SAAS,CACnC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAC7E,CAAC;IACF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,2BAA2B,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAqB,EACrB,aAAuB;IAEvB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,OAAO,uBAAuB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,aAAa,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAqB,EACrB,aAAuB;IAEvB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,MAAM,GAAG,GAAG,uBAAuB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/C,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1D,OAAO,GAAG,GAAG,aAAa,IAAI,aAAa,GAAG,IAAI,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC;QACxB,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * CIP-113 Programmable Tokens SDK
+ *
+ * @example
+ * ```ts
+ * import { CIP113 } from '@cip113/sdk';
+ * import { dummySubstandard } from '@cip113/sdk/dummy';
+ * import { freezeAndSeizeSubstandard } from '@cip113/sdk/freeze-and-seize';
+ *
+ * // Create Evolution SDK client
+ * const evoClient = client(preprod)
+ *   .withBlockfrost({ projectId: '...' })
+ *   .withAddress(walletAddress);
+ *
+ * const protocol = CIP113.init({
+ *   client: evoClient,
+ *   standard: { blueprint: standardBlueprint, deployment: deploymentParams },
+ *   substandards: [dummySubstandard({ blueprint: dummyBlueprint })],
+ * });
+ *
+ * const tx = await protocol.register('freeze-and-seize', { ... });
+ * ```
+ */
+import type { DeploymentParams, PlutusBlueprint } from "./types.js";
+import type { EvoClient, SubstandardPlugin, RegisterParams, MintParams, BurnParams, TransferParams, FreezeParams, UnfreezeParams, SeizeParams, InitComplianceParams, UnsignedTx } from "./substandards/interface.js";
+import { type ResolvedStandardScripts } from "./standard/scripts.js";
+export interface CIP113Config {
+    /** Evolution SDK client (ReadOnlyClient or SigningClient) */
+    client: EvoClient;
+    /** Standard protocol configuration */
+    standard: {
+        blueprint: PlutusBlueprint;
+        deployment: DeploymentParams;
+    };
+    /** Substandard plugins to register */
+    substandards?: SubstandardPlugin[];
+}
+export interface CIP113Protocol {
+    /** The resolved standard scripts (cached, reusable) */
+    readonly scripts: ResolvedStandardScripts;
+    /** The deployment parameters */
+    readonly deployment: DeploymentParams;
+    /** The Evolution SDK client */
+    readonly client: EvoClient;
+    /** Register a new programmable token */
+    register(substandardId: string, params: RegisterParams): Promise<UnsignedTx>;
+    /** Mint additional tokens */
+    mint(params: MintParams): Promise<UnsignedTx>;
+    /** Burn tokens */
+    burn(params: BurnParams): Promise<UnsignedTx>;
+    /** Transfer tokens */
+    transfer(params: TransferParams): Promise<UnsignedTx>;
+    compliance: {
+        /** Initialize compliance infrastructure (e.g., blacklist) */
+        init(substandardId: string, params: InitComplianceParams): Promise<UnsignedTx>;
+        /** Freeze an address */
+        freeze(params: FreezeParams): Promise<UnsignedTx>;
+        /** Unfreeze an address */
+        unfreeze(params: UnfreezeParams): Promise<UnsignedTx>;
+        /** Seize tokens */
+        seize(params: SeizeParams): Promise<UnsignedTx>;
+    };
+    /** Register a new substandard plugin at runtime */
+    registerSubstandard(plugin: SubstandardPlugin): void;
+    /** Get a registered substandard by ID */
+    getSubstandard(id: string): SubstandardPlugin | undefined;
+    /** List all registered substandard IDs */
+    listSubstandards(): string[];
+}
+export declare const CIP113: {
+    /**
+     * Initialize a CIP-113 protocol instance.
+     *
+     * This validates the standard blueprint, parameterizes all standard scripts,
+     * and initializes registered substandards.
+     */
+    init(config: CIP113Config): CIP113Protocol;
+};
+export type { EvoClient, SubstandardPlugin, SubstandardFactory, SubstandardContext, RegisterParams, MintParams, BurnParams, TransferParams, FreezeParams, UnfreezeParams, SeizeParams, InitComplianceParams, UnsignedTx, CIP68MetadataInput, } from "./substandards/interface.js";
+export type { DeploymentParams, PlutusBlueprint, PlutusScript, TxInput, UTxO, Network, PolicyId, ScriptHash, HexString, Assets, } from "./types.js";
+export { buildEvoScript, computeScriptHash, parameterizeScript, scriptAddress, rewardAddress, baseAddress, stakingCredentialHash, paymentCredentialHash, stringToHex, MAX_NEXT, voidData, outputReference, scriptCredential, keyCredential, labeledAssetName, stripCIP67Label, hasCIP67Label, buildCIP68FTDatum, } from "./core/evo-utils.js";
+export { sortTxInputs, findRefInputIndex } from "./core/registry.js";
+export { addressHexToBech32 } from "./provider/address-utils.js";
+export { assembleSignedTx } from "./provider/tx-utils.js";
+export type { FESDeploymentParams } from "./substandards/freeze-and-seize/types.js";
+export { preview as previewChain, preprod as preprodChain, mainnet as mainnetChain, Address as EvoAddress, Assets as EvoAssets, TransactionHash as EvoTransactionHash, Transaction as EvoTransaction, Data as EvoData, } from "@evolution-sdk/evolution";
+import { Client } from "@evolution-sdk/evolution";
+export declare const evoClient: (chain?: import("@evolution-sdk/evolution").Chain) => Client.ClientAssembly;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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