pha-deploy 0.2.0

package/dist/actions/createToken.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTokenCfg = void 0;
+exports.createToken = createToken;
+const phantasma_sdk_ts_1 = require("phantasma-sdk-ts");
+const waitForTx_1 = require("./waitForTx");
+const helpers_1 = require("./helpers");
+class createTokenCfg {
+    rpc;
+    nexus;
+    wif;
+    symbol;
+    gasFeeBase;
+    gasFeeCreateTokenBase;
+    gasFeeCreateTokenSymbol;
+    gasFeeMultiplier;
+    createTokenMaxData;
+    tokenSchemas;
+    tokenMetadataFields;
+    tokenType;
+    tokenMaxSupply;
+    fungibleDecimals;
+    constructor(rpc, nexus, wif, symbol, gasFeeBase, gasFeeCreateTokenBase, gasFeeCreateTokenSymbol, gasFeeMultiplier, createTokenMaxData, tokenSchemas, tokenMetadataFields, tokenType, tokenMaxSupply, fungibleDecimals) {
+        this.rpc = rpc;
+        this.nexus = nexus;
+        this.wif = wif;
+        this.symbol = symbol;
+        this.gasFeeBase = gasFeeBase;
+        this.gasFeeCreateTokenBase = gasFeeCreateTokenBase;
+        this.gasFeeCreateTokenSymbol = gasFeeCreateTokenSymbol;
+        this.gasFeeMultiplier = gasFeeMultiplier;
+        this.createTokenMaxData = createTokenMaxData;
+        this.tokenSchemas = tokenSchemas;
+        this.tokenMetadataFields = tokenMetadataFields;
+        this.tokenType = tokenType;
+        this.tokenMaxSupply = tokenMaxSupply;
+        this.fungibleDecimals = fungibleDecimals;
+        this.rpc = rpc;
+        this.nexus = nexus;
+        this.wif = wif;
+        this.symbol = symbol;
+        this.gasFeeBase = gasFeeBase;
+        this.gasFeeCreateTokenBase = gasFeeCreateTokenBase;
+        this.gasFeeCreateTokenSymbol = gasFeeCreateTokenSymbol;
+        this.gasFeeMultiplier = gasFeeMultiplier;
+        this.createTokenMaxData = createTokenMaxData;
+        this.tokenSchemas = tokenSchemas;
+        this.tokenMetadataFields = tokenMetadataFields;
+        this.tokenType = tokenType;
+        this.tokenMaxSupply = tokenMaxSupply;
+        this.fungibleDecimals = fungibleDecimals;
+    }
+    toPrintable() {
+        // Do not leak WIF; derive owner
+        const { wif: _omit, ...rest } = this; // rest has all public fields except wif
+        const owner = phantasma_sdk_ts_1.PhantasmaKeys.fromWIF(this.wif).Address.toString();
+        return {
+            ...rest,
+            owner,
+        };
+    }
+}
+exports.createTokenCfg = createTokenCfg;
+async function createToken(cfg, dryRun) {
+    const txSender = phantasma_sdk_ts_1.PhantasmaKeys.fromWIF(cfg.wif);
+    const senderPubKey = new phantasma_sdk_ts_1.Bytes32(txSender.PublicKey);
+    console.log("Deploying new token using these settings:", JSON.stringify(cfg.toPrintable(), helpers_1.bigintReplacer, 2));
+    if (cfg.tokenMetadataFields == null) {
+        throw Error('Token metadata is mandatory');
+    }
+    const tokenType = cfg.tokenType === "fungible" ? "fungible" : "nft";
+    const isFungible = tokenType === "fungible";
+    let maxSupply;
+    let decimals = 0;
+    if (isFungible) {
+        if (cfg.tokenMaxSupply == null) {
+            throw Error("token_max_supply is required for fungible tokens");
+        }
+        if (cfg.fungibleDecimals == null) {
+            throw Error("fungible_decimals is required for fungible tokens");
+        }
+        if (!Number.isInteger(cfg.fungibleDecimals) || cfg.fungibleDecimals < 0) {
+            throw Error("fungible_decimals must be a non-negative integer");
+        }
+        if (cfg.fungibleDecimals > 255) {
+            throw Error("fungible_decimals must be <= 255");
+        }
+    }
+    const maxSupplyValue = cfg.tokenMaxSupply != null ? cfg.tokenMaxSupply : 0n;
+    if (maxSupplyValue < 0n) {
+        throw Error("token_max_supply must be non-negative");
+    }
+    if (isFungible) {
+        decimals = cfg.fungibleDecimals;
+        maxSupply = phantasma_sdk_ts_1.IntX.fromBigInt(maxSupplyValue);
+    }
+    else {
+        maxSupply =
+            maxSupplyValue === 0n
+                ? phantasma_sdk_ts_1.IntX.fromI64(0n)
+                : phantasma_sdk_ts_1.IntX.fromBigInt(maxSupplyValue);
+    }
+    const info = phantasma_sdk_ts_1.TokenInfoBuilder.build(cfg.symbol, maxSupply, !isFungible, decimals, senderPubKey, phantasma_sdk_ts_1.TokenMetadataBuilder.buildAndSerialize(cfg.tokenMetadataFields.fields), cfg.tokenSchemas);
+    const feeOptions = new phantasma_sdk_ts_1.CreateTokenFeeOptions(cfg.gasFeeBase, cfg.gasFeeCreateTokenBase, cfg.gasFeeCreateTokenSymbol, cfg.gasFeeMultiplier);
+    const tx = phantasma_sdk_ts_1.CreateTokenTxHelper.buildTxAndSignHex(info, txSender, feeOptions, cfg.createTokenMaxData);
+    if (dryRun) {
+        console.log(`[dry-run] Prepared tx (not sent): ${tx}`);
+        console.log(phantasma_sdk_ts_1.CarbonBlob.NewFromBytes(phantasma_sdk_ts_1.SignedTxMsg, (0, phantasma_sdk_ts_1.hexToBytes)(tx), 0));
+        return;
+    }
+    console.log("Broadcasting transaction...");
+    const rpc = new phantasma_sdk_ts_1.PhantasmaAPI(cfg.rpc, null, cfg.nexus);
+    let txHash = await rpc.sendCarbonTransaction(tx);
+    console.log("txHash: ", txHash);
+    const { success, result } = await (0, waitForTx_1.waitForTx)(rpc, txHash);
+    if (success) {
+        var tokenId = phantasma_sdk_ts_1.CreateTokenTxHelper.parseResult(result);
+        console.log("Deployed carbon token ID:", tokenId);
+    }
+    else {
+        console.log("Could not deploy token");
+    }
+}
+//# sourceMappingURL=createToken.js.map

package/dist/actions/createToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createToken.js","sourceRoot":"","sources":["../../src/actions/createToken.ts"],"names":[],"mappings":";;;AA+DA,kCA8FC;AA7JD,uDAa0B;AAE1B,2CAAwC;AACxC,uCAAqD;AAErD,MAAa,cAAc;IAEhB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAdT,YACS,GAAW,EACX,KAAa,EACb,GAAW,EACX,MAAc,EACd,UAAkB,EAClB,qBAA6B,EAC7B,uBAA+B,EAC/B,gBAAwB,EACxB,kBAA0B,EAC1B,YAA6C,EAC7C,mBAA6B,EAC7B,SAAoB,EACpB,cAAyC,EACzC,gBAA2C;QAb3C,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAQ;QACb,QAAG,GAAH,GAAG,CAAQ;QACX,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;QAClB,0BAAqB,GAArB,qBAAqB,CAAQ;QAC7B,4BAAuB,GAAvB,uBAAuB,CAAQ;QAC/B,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,uBAAkB,GAAlB,kBAAkB,CAAQ;QAC1B,iBAAY,GAAZ,YAAY,CAAiC;QAC7C,wBAAmB,GAAnB,mBAAmB,CAAU;QAC7B,cAAS,GAAT,SAAS,CAAW;QACpB,mBAAc,GAAd,cAAc,CAA2B;QACzC,qBAAgB,GAAhB,gBAAgB,CAA2B;QAElD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,qBAAqB,GAAG,qBAAqB,CAAC;QACnD,IAAI,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;QACvD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IAED,WAAW;QACT,gCAAgC;QAChC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,wCAAwC;QAC9E,MAAM,KAAK,GAAG,gCAAa,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEjE,OAAO;YACL,GAAG,IAAI;YACP,KAAK;SACN,CAAC;IACJ,CAAC;CACF;AA3CD,wCA2CC;AAEM,KAAK,UAAU,WAAW,CAAC,GAAmB,EAAE,MAAe;IACpE,MAAM,QAAQ,GAAG,gCAAa,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,0BAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAErD,OAAO,CAAC,GAAG,CACT,2CAA2C,EAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,wBAAc,EAAE,CAAC,CAAC,CACrD,CAAC;IAEF,IAAI,GAAG,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,MAAM,UAAU,GAAG,SAAS,KAAK,UAAU,CAAC;IAE5C,IAAI,SAAe,CAAC;IACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,GAAG,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,GAAG,CAAC,gBAAgB,IAAI,IAAI,EAAE,CAAC;YACjC,MAAM,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;YACxE,MAAM,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,GAAG,CAAC,gBAAgB,GAAG,GAAG,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAClB,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;QACxB,MAAM,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,QAAQ,GAAG,GAAG,CAAC,gBAAiB,CAAC;QACjC,SAAS,GAAG,uBAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,SAAS;YACP,cAAc,KAAK,EAAE;gBACnB,CAAC,CAAC,uBAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClB,CAAC,CAAC,uBAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,mCAAgB,CAAC,KAAK,CACjC,GAAG,CAAC,MAAM,EACV,SAAS,EACT,CAAC,UAAU,EACX,QAAQ,EACR,YAAY,EACZ,uCAAoB,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,EACtE,GAAG,CAAC,YAAY,CACjB,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,wCAAqB,CAC1C,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,qBAAqB,EACzB,GAAG,CAAC,uBAAuB,EAC3B,GAAG,CAAC,gBAAgB,CACrB,CAAC;IAEF,MAAM,EAAE,GAAG,sCAAmB,CAAC,iBAAiB,CAC9C,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,GAAG,CAAC,kBAAkB,CACvB,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,6BAAU,CAAC,YAAY,CAAC,8BAAW,EAAE,IAAA,6BAAU,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAE3C,MAAM,GAAG,GAAG,IAAI,+BAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAEvD,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,qBAAS,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEzD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,GAAG,sCAAmB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;AACH,CAAC","sourcesContent":["import {\n  Bytes32,\n  CarbonBlob,\n  CreateTokenFeeOptions,\n  CreateTokenTxHelper,\n  hexToBytes,\n  IntX,\n  SignedTxMsg,\n  PhantasmaAPI,\n  PhantasmaKeys,\n  TokenInfoBuilder,\n  TokenMetadataBuilder,\n  TokenSchemas,\n} from \"phantasma-sdk-ts\";\nimport { TokenType } from \"../config\";\nimport { waitForTx } from \"./waitForTx\";\nimport { bigintReplacer, Metadata } from \"./helpers\";\n\nexport class createTokenCfg {\n  constructor(\n    public rpc: string,\n    public nexus: string,\n    public wif: string,\n    public symbol: string,\n    public gasFeeBase: bigint,\n    public gasFeeCreateTokenBase: bigint,\n    public gasFeeCreateTokenSymbol: bigint,\n    public gasFeeMultiplier: bigint,\n    public createTokenMaxData: bigint,\n    public tokenSchemas: TokenSchemas | null | undefined,\n    public tokenMetadataFields: Metadata,\n    public tokenType: TokenType,\n    public tokenMaxSupply: bigint | null | undefined,\n    public fungibleDecimals: number | null | undefined,\n  ) {\n    this.rpc = rpc;\n    this.nexus = nexus;\n    this.wif = wif;\n    this.symbol = symbol;\n    this.gasFeeBase = gasFeeBase;\n    this.gasFeeCreateTokenBase = gasFeeCreateTokenBase;\n    this.gasFeeCreateTokenSymbol = gasFeeCreateTokenSymbol;\n    this.gasFeeMultiplier = gasFeeMultiplier;\n    this.createTokenMaxData = createTokenMaxData;\n    this.tokenSchemas = tokenSchemas;\n    this.tokenMetadataFields = tokenMetadataFields;\n    this.tokenType = tokenType;\n    this.tokenMaxSupply = tokenMaxSupply;\n    this.fungibleDecimals = fungibleDecimals;\n  }\n\n  toPrintable() {\n    // Do not leak WIF; derive owner\n    const { wif: _omit, ...rest } = this; // rest has all public fields except wif\n    const owner = PhantasmaKeys.fromWIF(this.wif).Address.toString();\n\n    return {\n      ...rest,\n      owner,\n    };\n  }\n}\n\nexport async function createToken(cfg: createTokenCfg, dryRun: boolean) {\n  const txSender = PhantasmaKeys.fromWIF(cfg.wif);\n  const senderPubKey = new Bytes32(txSender.PublicKey);\n\n  console.log(\n    \"Deploying new token using these settings:\",\n    JSON.stringify(cfg.toPrintable(), bigintReplacer, 2),\n  );\n\n  if (cfg.tokenMetadataFields == null) {\n    throw Error('Token metadata is mandatory');\n  }\n\n  const tokenType = cfg.tokenType === \"fungible\" ? \"fungible\" : \"nft\";\n  const isFungible = tokenType === \"fungible\";\n\n  let maxSupply: IntX;\n  let decimals = 0;\n\n  if (isFungible) {\n    if (cfg.tokenMaxSupply == null) {\n      throw Error(\"token_max_supply is required for fungible tokens\");\n    }\n    if (cfg.fungibleDecimals == null) {\n      throw Error(\"fungible_decimals is required for fungible tokens\");\n    }\n    if (!Number.isInteger(cfg.fungibleDecimals) || cfg.fungibleDecimals < 0) {\n      throw Error(\"fungible_decimals must be a non-negative integer\");\n    }\n    if (cfg.fungibleDecimals > 255) {\n      throw Error(\"fungible_decimals must be <= 255\");\n    }\n  }\n\n  const maxSupplyValue =\n    cfg.tokenMaxSupply != null ? cfg.tokenMaxSupply : 0n;\n  if (maxSupplyValue < 0n) {\n    throw Error(\"token_max_supply must be non-negative\");\n  }\n  if (isFungible) {\n    decimals = cfg.fungibleDecimals!;\n    maxSupply = IntX.fromBigInt(maxSupplyValue);\n  } else {\n    maxSupply =\n      maxSupplyValue === 0n\n        ? IntX.fromI64(0n)\n        : IntX.fromBigInt(maxSupplyValue);\n  }\n\n  const info = TokenInfoBuilder.build(\n    cfg.symbol,\n    maxSupply,\n    !isFungible,\n    decimals,\n    senderPubKey,\n    TokenMetadataBuilder.buildAndSerialize(cfg.tokenMetadataFields.fields),\n    cfg.tokenSchemas\n  );\n\n  const feeOptions = new CreateTokenFeeOptions(\n    cfg.gasFeeBase,\n    cfg.gasFeeCreateTokenBase,\n    cfg.gasFeeCreateTokenSymbol,\n    cfg.gasFeeMultiplier,\n  );\n\n  const tx = CreateTokenTxHelper.buildTxAndSignHex(\n    info,\n    txSender,\n    feeOptions,\n    cfg.createTokenMaxData,\n  );\n\n  if (dryRun) {\n    console.log(`[dry-run] Prepared tx (not sent): ${tx}`);\n    console.log(CarbonBlob.NewFromBytes(SignedTxMsg, hexToBytes(tx), 0));\n    return;\n  }\n\n  console.log(\"Broadcasting transaction...\");\n\n  const rpc = new PhantasmaAPI(cfg.rpc, null, cfg.nexus);\n\n  let txHash = await rpc.sendCarbonTransaction(tx);\n  console.log(\"txHash: \", txHash);\n\n  const { success, result } = await waitForTx(rpc, txHash);\n\n  if (success) {\n    var tokenId = CreateTokenTxHelper.parseResult(result);\n    console.log(\"Deployed carbon token ID:\", tokenId);\n  } else {\n    console.log(\"Could not deploy token\");\n  }\n}\n"]}

package/dist/actions/helpers.d.ts

@@ -0,0 +1,11 @@
+export declare const bigintReplacer: (_: string, v: unknown) => unknown;
+export type MetadataFields = Record<string, unknown>;
+export declare class Metadata {
+    fields?: MetadataFields | undefined;
+    jsonName: string;
+    constructor(fields: MetadataFields | undefined, jsonName: string);
+    pickString(mandatory: boolean, key: string): string | undefined;
+    pickHexAndDecode(mandatory: boolean, key: string): Uint8Array | undefined;
+    pickNumber(mandatory: boolean, key: string): number | undefined;
+}
+//# sourceMappingURL=helpers.d.ts.map

package/dist/actions/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/actions/helpers.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,GAAG,OAAO,YACV,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,qBAAa,QAAQ;IACnB,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM;IAKhE,UAAU,CACR,SAAS,EAAE,OAAO,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS;IAoBrB,gBAAgB,CACd,SAAS,EAAE,OAAO,EAClB,GAAG,EAAE,MAAM,GACV,UAAU,GAAG,SAAS;IASzB,UAAU,CACR,SAAS,EAAE,OAAO,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS;CAwCtB"}

package/dist/actions/helpers.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Metadata = exports.bigintReplacer = void 0;
+const phantasma_sdk_ts_1 = require("phantasma-sdk-ts");
+// Helper: stringify BigInt as string
+const bigintReplacer = (_, v) => typeof v === "bigint" ? v.toString() : v;
+exports.bigintReplacer = bigintReplacer;
+class Metadata {
+    fields;
+    jsonName;
+    constructor(fields, jsonName) {
+        this.fields = fields;
+        this.jsonName = jsonName;
+    }
+    pickString(mandatory, key) {
+        if (!this.fields) {
+            return undefined;
+        }
+        const value = this.fields[key];
+        if (!value) {
+            return undefined;
+        }
+        if (typeof value === "string") {
+            const trimmed = value.trim();
+            if (trimmed.length === 0 && mandatory) {
+                throw new Error(`${this.jsonName}.${key} cannot be empty`);
+            }
+            return trimmed;
+        }
+        throw new Error(`${this.jsonName}.${key} must be a string`);
+    }
+    pickHexAndDecode(mandatory, key) {
+        const s = this.pickString(mandatory, key);
+        if (!s) {
+            return undefined;
+        }
+        return (0, phantasma_sdk_ts_1.hexToBytes)(s);
+    }
+    pickNumber(mandatory, key) {
+        if (!this.fields) {
+            return undefined;
+        }
+        let value = this.fields[key];
+        if (value == null) {
+            if (mandatory) {
+                throw new Error(`${this.jsonName}.${key} is required`);
+            }
+            else {
+                return undefined;
+            }
+        }
+        if (typeof value === "string") {
+            const trimmed = value.trim();
+            if (trimmed.length === 0) {
+                throw new Error(`${this.jsonName}.${key} cannot be empty`);
+            }
+            value = Number(trimmed);
+        }
+        else if (typeof value === "bigint") {
+            value = Number(value);
+        }
+        else if (typeof value !== "number") {
+            throw new Error(`${this.jsonName}.${key} must be a number or numeric string`);
+        }
+        if (typeof value !== "number") {
+            throw new Error(`${this.jsonName}.${key} should be convertable to number`);
+        }
+        if (!Number.isFinite(value) || !Number.isInteger(value)) {
+            throw new Error(`${this.jsonName}.${key} must be an integer`);
+        }
+        if (value < 0) {
+            throw new Error(`${this.jsonName}.${key} must be non-negative`);
+        }
+        return value;
+    }
+}
+exports.Metadata = Metadata;
+//# sourceMappingURL=helpers.js.map

package/dist/actions/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/actions/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import { hexToBytes } from \"phantasma-sdk-ts\";\n\n// Helper: stringify BigInt as string\nexport const bigintReplacer = (_: string, v: unknown) =>\n  typeof v === \"bigint\" ? v.toString() : v;\n\nexport type MetadataFields = Record<string, unknown>;\n\nexport class Metadata {\n  fields?: MetadataFields | undefined;\n  jsonName: string;\n\n  constructor(fields: MetadataFields | undefined, jsonName: string ) {\n    this.fields = fields\n    this.jsonName = jsonName\n  }\n\n  pickString(\n    mandatory: boolean,\n    key: string\n  ): string | undefined {\n    if (!this.fields) {\n      return undefined;\n    }\n\n    const value = this.fields[key];\n    if (!value) {\n      return undefined;\n    }\n\n    if (typeof value === \"string\") {\n      const trimmed = value.trim();\n      if (trimmed.length === 0 && mandatory) {\n        throw new Error(`${this.jsonName}.${key} cannot be empty`);\n      }\n      return trimmed;\n    }\n    throw new Error(`${this.jsonName}.${key} must be a string`);\n  }\n\n  pickHexAndDecode(\n    mandatory: boolean,\n    key: string\n  ): Uint8Array | undefined {\n    const s = this.pickString(mandatory, key);\n    if(!s){\n      return undefined;\n    }\n\n    return hexToBytes(s);\n  }\n\n  pickNumber(\n    mandatory: boolean,\n    key: string\n  ): number | undefined {\n    if (!this.fields) {\n      return undefined;\n    }\n\n    let value = this.fields[key];\n\n    if (value == null) {\n      if (mandatory) {\n        throw new Error(`${this.jsonName}.${key} is required`);\n      } else {\n        return undefined;\n      }\n    }\n\n    if (typeof value === \"string\") {\n      const trimmed = (value as string).trim();\n      if (trimmed.length === 0) {\n        throw new Error(`${this.jsonName}.${key} cannot be empty`);\n      }\n      value = Number(trimmed);\n    } else if (typeof value === \"bigint\") {\n      value = Number(value);\n    } else if(typeof value !== \"number\"){\n      throw new Error(`${this.jsonName}.${key} must be a number or numeric string`);\n    }\n\n    if (typeof value !== \"number\") {\n      throw new Error(`${this.jsonName}.${key} should be convertable to number`);\n    }\n\n    if (!Number.isFinite(value) || !Number.isInteger(value)) {\n      throw new Error(`${this.jsonName}.${key} must be an integer`);\n    }\n    if (value < 0) {\n      throw new Error(`${this.jsonName}.${key} must be non-negative`);\n    }\n\n    return value;\n  }\n}\n"]}

package/dist/actions/mintNftToken.d.ts

@@ -0,0 +1,20 @@
+import { VmStructSchema, MetadataField } from "phantasma-sdk-ts";
+export declare class mintNftTokenCfg {
+    rpc: string;
+    nexus: string;
+    wif: string;
+    carbonTokenId: bigint;
+    carbonSeriesId: number;
+    nftRomSchema: VmStructSchema;
+    nftMetadata: MetadataField[];
+    gasFeeBase: bigint;
+    gasFeeMultiplier: bigint;
+    mintTokenMaxData: bigint;
+    constructor(rpc: string, nexus: string, wif: string, carbonTokenId: bigint, carbonSeriesId: number, nftRomSchema: VmStructSchema, nftMetadata: MetadataField[], gasFeeBase: bigint, gasFeeMultiplier: bigint, mintTokenMaxData: bigint);
+    toPrintable(): Omit<this, "wif" | "toPrintable" | "nftMetadata"> & {
+        owner: string;
+        nftMetadata: MetadataField[];
+    };
+}
+export declare function mintNftToken(cfg: mintNftTokenCfg, dryRun: boolean): Promise<void>;
+//# sourceMappingURL=mintNftToken.d.ts.map

package/dist/actions/mintNftToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintNftToken.d.ts","sourceRoot":"","sources":["../../src/actions/mintNftToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,cAAc,EACd,aAAa,EACd,MAAM,kBAAkB,CAAC;AAI1B,qBAAa,eAAe;IAEjB,GAAG,EAAE,MAAM;IACX,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,MAAM;IACX,aAAa,EAAE,MAAM;IACrB,cAAc,EAAE,MAAM;IACtB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa,EAAE;IAC5B,UAAU,EAAE,MAAM;IAClB,gBAAgB,EAAE,MAAM;IACxB,gBAAgB,EAAE,MAAM;gBATxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,cAAc,EAC5B,WAAW,EAAE,aAAa,EAAE,EAC5B,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM;IAcjC,WAAW;;;;CAYZ;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,iBA2DvE"}

package/dist/actions/mintNftToken.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mintNftTokenCfg = void 0;
+exports.mintNftToken = mintNftToken;
+const phantasma_sdk_ts_1 = require("phantasma-sdk-ts");
+const waitForTx_1 = require("./waitForTx");
+const helpers_1 = require("./helpers");
+class mintNftTokenCfg {
+    rpc;
+    nexus;
+    wif;
+    carbonTokenId;
+    carbonSeriesId;
+    nftRomSchema;
+    nftMetadata;
+    gasFeeBase;
+    gasFeeMultiplier;
+    mintTokenMaxData;
+    constructor(rpc, nexus, wif, carbonTokenId, carbonSeriesId, nftRomSchema, nftMetadata, gasFeeBase, gasFeeMultiplier, mintTokenMaxData) {
+        this.rpc = rpc;
+        this.nexus = nexus;
+        this.wif = wif;
+        this.carbonTokenId = carbonTokenId;
+        this.carbonSeriesId = carbonSeriesId;
+        this.nftRomSchema = nftRomSchema;
+        this.nftMetadata = nftMetadata;
+        this.gasFeeBase = gasFeeBase;
+        this.gasFeeMultiplier = gasFeeMultiplier;
+        this.mintTokenMaxData = mintTokenMaxData;
+        this.rpc = rpc;
+        this.nexus = nexus;
+        this.wif = wif;
+        this.carbonTokenId = carbonTokenId;
+        this.carbonSeriesId = carbonSeriesId;
+        this.nftRomSchema = nftRomSchema;
+        this.nftMetadata = nftMetadata;
+        this.gasFeeBase = gasFeeBase;
+        this.gasFeeMultiplier = gasFeeMultiplier;
+        this.mintTokenMaxData = mintTokenMaxData;
+    }
+    toPrintable() {
+        // Do not leak WIF; derive owner
+        const { wif: _omit, nftMetadata, ...rest } = this; // rest has all public fields except wif/metadata strings
+        const owner = phantasma_sdk_ts_1.PhantasmaKeys.fromWIF(this.wif).Address.toString();
+        return {
+            ...rest,
+            owner,
+            nftMetadata
+        };
+    }
+}
+exports.mintNftTokenCfg = mintNftTokenCfg;
+async function mintNftToken(cfg, dryRun) {
+    const txSender = phantasma_sdk_ts_1.PhantasmaKeys.fromWIF(cfg.wif);
+    const senderPubKey = new phantasma_sdk_ts_1.Bytes32(txSender.PublicKey);
+    const newPhantasmaNftId = await (0, phantasma_sdk_ts_1.getRandomPhantasmaId)();
+    console.log(`Minting new token '${newPhantasmaNftId}' using these settings:`, JSON.stringify(cfg.toPrintable(), helpers_1.bigintReplacer, 2));
+    const rom = phantasma_sdk_ts_1.NftRomBuilder.buildAndSerialize(cfg.nftRomSchema, newPhantasmaNftId, cfg.nftMetadata);
+    const feeOptions = new phantasma_sdk_ts_1.MintNftFeeOptions(cfg.gasFeeBase, cfg.gasFeeMultiplier);
+    const tx = phantasma_sdk_ts_1.MintNonFungibleTxHelper.buildTxAndSignHex(cfg.carbonTokenId, cfg.carbonSeriesId, txSender, senderPubKey, rom, new Uint8Array(), feeOptions, cfg.mintTokenMaxData);
+    if (dryRun) {
+        console.log(`[dry-run] Prepared tx (not sent): ${tx}`);
+        console.log(phantasma_sdk_ts_1.CarbonBlob.NewFromBytes(phantasma_sdk_ts_1.SignedTxMsg, (0, phantasma_sdk_ts_1.hexToBytes)(tx), 0));
+        return;
+    }
+    console.log("Broadcasting transaction...");
+    const rpc = new phantasma_sdk_ts_1.PhantasmaAPI(cfg.rpc, null, cfg.nexus);
+    let txHash = await rpc.sendCarbonTransaction(tx);
+    console.log("txHash: ", txHash);
+    const { success, result } = await (0, waitForTx_1.waitForTx)(rpc, txHash);
+    if (success) {
+        const carbonNftAddresses = phantasma_sdk_ts_1.MintNonFungibleTxHelper.parseResult(cfg.carbonTokenId, result);
+        console.log(`Deployed NFT with phantasma ID ${newPhantasmaNftId} and carbon NFT address ${carbonNftAddresses[0]}`);
+    }
+    else {
+        console.log("Could not mint NFT");
+    }
+}
+//# sourceMappingURL=mintNftToken.js.map

package/dist/actions/mintNftToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintNftToken.js","sourceRoot":"","sources":["../../src/actions/mintNftToken.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Bytes32,\n  CarbonBlob,\n  hexToBytes,\n  getRandomPhantasmaId,\n  MintNftFeeOptions,\n  MintNonFungibleTxHelper,\n  NftRomBuilder,\n  PhantasmaAPI,\n  PhantasmaKeys,\n  SignedTxMsg,\n  VmStructSchema,\n  MetadataField,\n} from \"phantasma-sdk-ts\";\nimport { waitForTx } from \"./waitForTx\";\nimport { bigintReplacer } from \"./helpers\";\n\nexport class mintNftTokenCfg {\n  constructor(\n    public rpc: string,\n    public nexus: string,\n    public wif: string,\n    public carbonTokenId: bigint,\n    public carbonSeriesId: number,\n    public nftRomSchema: VmStructSchema,\n    public nftMetadata: MetadataField[],\n    public gasFeeBase: bigint,\n    public gasFeeMultiplier: bigint,\n    public mintTokenMaxData: bigint,\n  ) {\n    this.rpc = rpc;\n    this.nexus = nexus;\n    this.wif = wif;\n    this.carbonTokenId = carbonTokenId;\n    this.carbonSeriesId = carbonSeriesId;\n    this.nftRomSchema = nftRomSchema;\n    this.nftMetadata = nftMetadata;\n    this.gasFeeBase = gasFeeBase;\n    this.gasFeeMultiplier = gasFeeMultiplier;\n    this.mintTokenMaxData = mintTokenMaxData;\n  }\n\n  toPrintable() {\n    // Do not leak WIF; derive owner\n    const { wif: _omit, nftMetadata, ...rest } =\n      this; // rest has all public fields except wif/metadata strings\n    const owner = PhantasmaKeys.fromWIF(this.wif).Address.toString();\n\n    return {\n      ...rest,\n      owner,\n      nftMetadata\n    };\n  }\n}\n\nexport async function mintNftToken(cfg: mintNftTokenCfg, dryRun: boolean) {\n  const txSender = PhantasmaKeys.fromWIF(cfg.wif);\n  const senderPubKey = new Bytes32(txSender.PublicKey);\n\n  const newPhantasmaNftId = await getRandomPhantasmaId();\n\n  console.log(\n    `Minting new token '${newPhantasmaNftId}' using these settings:`,\n    JSON.stringify(cfg.toPrintable(), bigintReplacer, 2),\n  );\n\n  const rom = NftRomBuilder.buildAndSerialize(\n    cfg.nftRomSchema,\n    newPhantasmaNftId,\n    cfg.nftMetadata\n  );\n\n  const feeOptions = new MintNftFeeOptions(\n    cfg.gasFeeBase,\n    cfg.gasFeeMultiplier,\n  );\n\n  const tx = MintNonFungibleTxHelper.buildTxAndSignHex(\n    cfg.carbonTokenId,\n    cfg.carbonSeriesId,\n    txSender,\n    senderPubKey,\n    rom,\n    new Uint8Array(),\n    feeOptions,\n    cfg.mintTokenMaxData,\n  );\n\n  if (dryRun) {\n    console.log(`[dry-run] Prepared tx (not sent): ${tx}`);\n    console.log(CarbonBlob.NewFromBytes(SignedTxMsg, hexToBytes(tx), 0));\n    return;\n  }\n\n  console.log(\"Broadcasting transaction...\");\n\n  const rpc = new PhantasmaAPI(cfg.rpc, null, cfg.nexus);\n\n  let txHash = await rpc.sendCarbonTransaction(tx);\n  console.log(\"txHash: \", txHash);\n\n  const { success, result } = await waitForTx(rpc, txHash);\n\n  if (success) {\n    const carbonNftAddresses = MintNonFungibleTxHelper.parseResult(\n      cfg.carbonTokenId,\n      result,\n    );\n    console.log(\n      `Deployed NFT with phantasma ID ${newPhantasmaNftId} and carbon NFT address ${carbonNftAddresses[0]}`,\n    );\n  } else {\n    console.log(\"Could not mint NFT\");\n  }\n}\n"]}

package/dist/actions/waitForTx.d.ts

@@ -0,0 +1,6 @@
+import { PhantasmaAPI } from "phantasma-sdk-ts";
+export declare function waitForTx(rpc: PhantasmaAPI, txHash: string): Promise<{
+    success: boolean;
+    result: string;
+}>;
+//# sourceMappingURL=waitForTx.d.ts.map

package/dist/actions/waitForTx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForTx.d.ts","sourceRoot":"","sources":["../../src/actions/waitForTx.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAEb,MAAM,kBAAkB,CAAC;AAE1B,wBAAsB,SAAS,CAC7B,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CA6DD"}

package/dist/actions/waitForTx.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForTx = waitForTx;
+const phantasma_sdk_ts_1 = require("phantasma-sdk-ts");
+async function waitForTx(rpc, txHash) {
+    const start = Date.now();
+    const timeoutMs = 30_000; // 30 seconds total
+    const intervalMs = 2_000; // poll every 2 seconds
+    let verified = false;
+    const runningName = phantasma_sdk_ts_1.ExecutionState[phantasma_sdk_ts_1.ExecutionState.Running];
+    const breakName = phantasma_sdk_ts_1.ExecutionState[phantasma_sdk_ts_1.ExecutionState.Break];
+    const faultName = phantasma_sdk_ts_1.ExecutionState[phantasma_sdk_ts_1.ExecutionState.Fault];
+    const haltName = phantasma_sdk_ts_1.ExecutionState[phantasma_sdk_ts_1.ExecutionState.Halt];
+    console.log("Waiting up to 30s for transaction execution state...");
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const txInfo = await rpc.getTransaction(txHash);
+            // Print only the state field for clarity
+            console.log("getTransaction response: state:", txInfo.state);
+            // txInfo.state is provided by the SDK as a string name (e.g. "Running","Halt", etc.)
+            const stateStr = txInfo.state;
+            if (stateStr === runningName) {
+                // still running -> continue polling
+            }
+            else if (stateStr === breakName || stateStr === faultName) {
+                // Break or Fault -> failure
+                console.log(`Transaction failed: ${stateStr} result: '${txInfo.result}' debugComment: '${txInfo.debugComment}'`);
+                verified = true;
+                break;
+            }
+            else if (stateStr === haltName) {
+                // Halt -> success
+                console.log("Transaction succeeded");
+                return { success: true, result: txInfo.result };
+            }
+            else {
+                // Unknown state name -> log and continue polling
+                console.log("Unknown ExecutionState value:", stateStr);
+            }
+        }
+        catch (err) {
+            // Transient RPC errors are logged and retried until timeout
+            const e = err;
+            console.log("Error while checking transaction status (will retry):", e && e.message ? e.message : String(err));
+        }
+        // wait before next poll
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    if (!verified) {
+        console.log("Unable to verify transaction execution state within 30 seconds. Please check manually. txHash:", txHash);
+    }
+    return { success: false, result: "" };
+}
+//# sourceMappingURL=waitForTx.js.map

package/dist/actions/waitForTx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForTx.js","sourceRoot":"","sources":["../../src/actions/waitForTx.ts"],"names":[],"mappings":";;AAMA,8BAmEC;AAzED,uDAI0B;AAEnB,KAAK,UAAU,SAAS,CAC7B,GAAiB,EACjB,MAAc;IAKd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,mBAAmB;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,uBAAuB;IACjD,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,WAAW,GAAG,iCAAc,CAAC,iCAAc,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,iCAAc,CAAC,iCAAc,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,iCAAc,CAAC,iCAAc,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,iCAAc,CAAC,iCAAc,CAAC,IAAI,CAAC,CAAC;IAErD,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IAEpE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAoB,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAEjE,yCAAyC;YACzC,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAE7D,qFAAqF;YACrF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;YAE9B,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC7B,oCAAoC;YACtC,CAAC;iBAAM,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC5D,4BAA4B;gBAC5B,OAAO,CAAC,GAAG,CACT,uBAAuB,QAAQ,aAAa,MAAM,CAAC,MAAM,oBAAoB,MAAM,CAAC,YAAY,GAAG,CACpG,CAAC;gBACF,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;iBAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,kBAAkB;gBAClB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;gBACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,iDAAiD;gBACjD,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,4DAA4D;YAC5D,MAAM,CAAC,GAAG,GAAY,CAAC;YACvB,OAAO,CAAC,GAAG,CACT,uDAAuD,EACvD,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACzC,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CACT,gGAAgG,EAChG,MAAM,CACP,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxC,CAAC","sourcesContent":["import {\n  ExecutionState,\n  PhantasmaAPI,\n  TransactionData,\n} from \"phantasma-sdk-ts\";\n\nexport async function waitForTx(\n  rpc: PhantasmaAPI,\n  txHash: string,\n): Promise<{\n  success: boolean;\n  result: string;\n}> {\n  const start = Date.now();\n  const timeoutMs = 30_000; // 30 seconds total\n  const intervalMs = 2_000; // poll every 2 seconds\n  let verified = false;\n\n  const runningName = ExecutionState[ExecutionState.Running];\n  const breakName = ExecutionState[ExecutionState.Break];\n  const faultName = ExecutionState[ExecutionState.Fault];\n  const haltName = ExecutionState[ExecutionState.Halt];\n\n  console.log(\"Waiting up to 30s for transaction execution state...\");\n\n  while (Date.now() - start < timeoutMs) {\n    try {\n      const txInfo: TransactionData = await rpc.getTransaction(txHash);\n\n      // Print only the state field for clarity\n      console.log(\"getTransaction response: state:\", txInfo.state);\n\n      // txInfo.state is provided by the SDK as a string name (e.g. \"Running\",\"Halt\", etc.)\n      const stateStr = txInfo.state;\n\n      if (stateStr === runningName) {\n        // still running -> continue polling\n      } else if (stateStr === breakName || stateStr === faultName) {\n        // Break or Fault -> failure\n        console.log(\n          `Transaction failed: ${stateStr} result: '${txInfo.result}' debugComment: '${txInfo.debugComment}'`,\n        );\n        verified = true;\n        break;\n      } else if (stateStr === haltName) {\n        // Halt -> success\n        console.log(\"Transaction succeeded\");\n        return { success: true, result: txInfo.result };\n      } else {\n        // Unknown state name -> log and continue polling\n        console.log(\"Unknown ExecutionState value:\", stateStr);\n      }\n    } catch (err) {\n      // Transient RPC errors are logged and retried until timeout\n      const e = err as Error;\n      console.log(\n        \"Error while checking transaction status (will retry):\",\n        e && e.message ? e.message : String(err),\n      );\n    }\n\n    // wait before next poll\n    await new Promise((r) => setTimeout(r, intervalMs));\n  }\n\n  if (!verified) {\n    console.log(\n      \"Unable to verify transaction execution state within 30 seconds. Please check manually. txHash:\",\n      txHash,\n    );\n  }\n\n  return { success: false, result: \"\" };\n}\n"]}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function main(): Promise<void>;
+export default main;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAmIA,iBAAe,IAAI,kBAsFlB;AAcD,eAAe,IAAI,CAAC"}

package/dist/cli.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpers_1 = require("yargs/helpers");
+const yargs_1 = __importDefault(require("yargs"));
+const config_1 = __importDefault(require("./config"));
+const createToken_1 = require("./actions/createToken");
+const createSeries_1 = require("./actions/createSeries");
+const mintNftToken_1 = require("./actions/mintNftToken");
+/**
+ * CLI for pha-deploy.
+ *
+ * Modes:
+ *  - CLI one-shot: use flags to perform actions immediately
+ *  - TOML-driven: use `--config` or default `config.toml` for config values
+ *
+ * Actions:
+ *  - create-token
+ *  - create-series
+ *  - mint-nft
+ */
+function requireArg(value, name) {
+    if (value === undefined || value === null) {
+        throw new Error(`${name} is required`);
+    }
+}
+/* ----------------------------- Actions ----------------------------- */
+async function actionCreateToken(cfg, dryRun) {
+    requireArg(cfg.rpc, "rpc");
+    requireArg(cfg.nexus, "nexus");
+    requireArg(cfg.wif, "wif");
+    requireArg(cfg.symbol, "symbol");
+    requireArg(cfg.gasFeeBase, "gas_fee_base");
+    requireArg(cfg.gasFeeCreateTokenBase, "gas_fee_create_token_base");
+    requireArg(cfg.gasFeeCreateTokenSymbol, "gas_fee_create_token_symbol");
+    requireArg(cfg.gasFeeMultiplier, "gas_fee_multiplier");
+    requireArg(cfg.createTokenMaxData, "create_token_max_data");
+    const tokenType = (cfg.tokenType ?? "nft") === "fungible" ? "fungible" : "nft";
+    if (tokenType === "fungible") {
+        requireArg(cfg.tokenMaxSupply, "token_max_supply");
+        requireArg(cfg.fungibleDecimals, "fungible_decimals");
+    }
+    await (0, createToken_1.createToken)(new createToken_1.createTokenCfg(cfg.rpc, cfg.nexus, cfg.wif, cfg.symbol, cfg.gasFeeBase, cfg.gasFeeCreateTokenBase, cfg.gasFeeCreateTokenSymbol, cfg.gasFeeMultiplier, cfg.createTokenMaxData, cfg.tokenSchemas, cfg.tokenMetadata, tokenType, cfg.tokenMaxSupply, cfg.fungibleDecimals), dryRun);
+}
+async function actionCreateSeries(cfg, dryRun) {
+    requireArg(cfg.rpc, "rpc");
+    requireArg(cfg.nexus, "nexus");
+    requireArg(cfg.wif, "wif");
+    requireArg(cfg.carbonTokenId, "carbon_token_id");
+    requireArg(cfg.tokenSchemas, "token_schemas");
+    requireArg(cfg.seriesMetadata, "series_metadata");
+    requireArg(cfg.gasFeeBase, "gas_fee_base");
+    requireArg(cfg.gasFeeCreateTokenSeries, "gas_fee_create_token_series");
+    requireArg(cfg.gasFeeMultiplier, "gas_fee_multiplier");
+    requireArg(cfg.createTokenSeriesMaxData, "create_token_series_max_data");
+    await (0, createSeries_1.createSeries)(new createSeries_1.createSeriesCfg(cfg.rpc, cfg.nexus, cfg.wif, cfg.carbonTokenId, cfg.gasFeeBase, cfg.gasFeeCreateTokenSeries, cfg.gasFeeMultiplier, cfg.createTokenSeriesMaxData, cfg.tokenSchemas?.seriesMetadata, cfg.seriesMetadata), dryRun);
+}
+async function actionMintNft(cfg, dryRun) {
+    requireArg(cfg.rpc, "rpc");
+    requireArg(cfg.nexus, "nexus");
+    requireArg(cfg.wif, "wif");
+    requireArg(cfg.carbonTokenId, "carbon_token_id");
+    requireArg(cfg.carbonTokenSeriesId, "carbon_token_series_id");
+    requireArg(cfg.tokenSchemas, "token_schemas");
+    requireArg(cfg.nftMetadata, "nft_metadata");
+    requireArg(cfg.gasFeeBase, "gas_fee_base");
+    requireArg(cfg.gasFeeMultiplier, "gas_fee_multiplier");
+    requireArg(cfg.mintTokenMaxData, "mint_token_max_data");
+    await (0, mintNftToken_1.mintNftToken)(new mintNftToken_1.mintNftTokenCfg(cfg.rpc, cfg.nexus, cfg.wif, cfg.carbonTokenId, cfg.carbonTokenSeriesId, cfg.tokenSchemas.rom, cfg.nftMetadata, cfg.gasFeeBase, cfg.gasFeeMultiplier, cfg.mintTokenMaxData), dryRun);
+}
+/* ------------------------------- Main ------------------------------- */
+async function main() {
+    // Pre-parse --config early so the TOML file can be loaded before the main yargs parsing.
+    const pre = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+        .option("config", {
+        type: "string",
+        alias: "c",
+        description: "Path to TOML config file (default: config.toml)",
+    })
+        .help(false)
+        .parseSync();
+    // Load TOML configuration (if present) before doing full parsing
+    const cfg = (0, config_1.default)({ configPath: pre.config ?? null });
+    // Minimal yargs parsing for the top-level CLI behavior
+    const argv = await (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+        .scriptName("pha-deploy")
+        .usage("Usage: $0 [options] [--create-token|--mint-nft|--transfer]")
+        .option("rpc", { type: "string", describe: "RPC endpoint" })
+        .option("nexus", { type: "string", describe: "Chain nexus" })
+        .option("wif", { type: "string", describe: "WIF for signing" })
+        .option("symbol", { type: "string", describe: "Token symbol" })
+        .option("token-type", {
+        type: "string",
+        choices: ["nft", "fungible"],
+        describe: "Token type to create (default: nft)",
+    })
+        .option("token-max-supply", {
+        type: "string",
+        describe: "Token max supply (optional for NFT; required when --token-type fungible)",
+    })
+        .option("fungible-decimals", {
+        type: "number",
+        describe: "Decimal places for fungible token (required when --token-type fungible)",
+    })
+        .option("dry-run", {
+        type: "boolean",
+        describe: "Do not broadcast transactions; just show payloads",
+    })
+        .option("config", {
+        type: "string",
+        describe: "Path to TOML config file (default: config.toml). Takes precedence as the file used for defaults.",
+    })
+        .option("create-token", { type: "boolean", describe: "Create a token" })
+        .option("create-series", {
+        type: "boolean",
+        describe: "Create a token series",
+    })
+        .option("mint-nft", { type: "boolean", describe: "Mint tokens" })
+        .help()
+        .alias("h", "help")
+        .epilog("pha-deploy - minimal template")
+        .parseAsync();
+    // Determine dry-run (CLI flag overrides config)
+    const dryRun = Boolean(argv["dry-run"]) || cfg.dryRun || false;
+    // One-shot actions: pick the first matching action
+    const actions = ["create-token", "create-series", "mint-nft"];
+    for (const action of actions) {
+        if (argv[action]) {
+            switch (action) {
+                case "create-token": {
+                    await actionCreateToken(cfg, dryRun);
+                    return;
+                }
+                case "create-series": {
+                    await actionCreateSeries(cfg, dryRun);
+                    return;
+                }
+                case "mint-nft": {
+                    await actionMintNft(cfg, dryRun);
+                    return;
+                }
+            }
+        }
+    }
+    // No action requested -> show help
+    console.log("No action specified. Pass an action flag (e.g. --create-token or --mint-nft).");
+    console.log("Use --help to see available flags.");
+}
+/* ----------------------------- Run Script ---------------------------- */
+if (require.main === module) {
+    main().catch((err) => {
+        console.error("Unhandled error in CLI:", err && err.stack ? err.stack : err);
+        process.exit(2);
+    });
+}
+exports.default = main;
+//# sourceMappingURL=cli.js.map