phantasma-sdk-ts 0.1.76 → 0.2.0-rc.1

package/dist/core/types/Carbon/Blockchain/SignedTxMsg.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignedTxMsg = void 0;
+const Bytes32_1 = require("../Bytes32");
+const Bytes64_1 = require("../Bytes64");
+const TxTypes_1 = require("../TxTypes");
+const Witness_1 = require("../Witness");
+const TxMsg_1 = require("./TxMsg");
+class SignedTxMsg {
+    constructor(msg, witnesses) {
+        this.msg = msg;
+        this.witnesses = witnesses;
+    }
+    write(w) {
+        this.msg.write(w);
+        switch (this.msg.type) {
+            case TxTypes_1.TxTypes.TransferFungible:
+            case TxTypes_1.TxTypes.TransferNonFungible_Single:
+            case TxTypes_1.TxTypes.TransferNonFungible_Multi:
+            case TxTypes_1.TxTypes.MintFungible:
+            case TxTypes_1.TxTypes.BurnFungible:
+            case TxTypes_1.TxTypes.MintNonFungible:
+            case TxTypes_1.TxTypes.BurnNonFungible: {
+                if (this.witnesses.length !== 1)
+                    throw new Error('Expected 1 witness');
+                const w0 = this.witnesses[0];
+                // assert witness address equals msg.gasFrom
+                if (!w0.address.equals(this.msg.gasFrom))
+                    throw new Error('Witness address mismatch');
+                w.write64(w0.signature.bytes);
+                break;
+            }
+            case TxTypes_1.TxTypes.TransferFungible_GasPayer:
+            case TxTypes_1.TxTypes.TransferNonFungible_Single_GasPayer:
+            case TxTypes_1.TxTypes.TransferNonFungible_Multi_GasPayer:
+            case TxTypes_1.TxTypes.BurnFungible_GasPayer:
+            case TxTypes_1.TxTypes.BurnNonFungible_GasPayer: {
+                if (this.witnesses.length !== 2)
+                    throw new Error('Expected 2 witnesses');
+                const w0 = this.witnesses[0];
+                const w1 = this.witnesses[1];
+                if (!w0.address.equals(this.msg.gasFrom))
+                    throw new Error('Gas witness address mismatch');
+                // selecting "from" depends on concrete message type
+                w.write64(w0.signature.bytes);
+                w.write64(w1.signature.bytes);
+                throw new Error('Unsupported transaction type');
+                break;
+            }
+            case TxTypes_1.TxTypes.Call:
+            case TxTypes_1.TxTypes.Call_Multi:
+            case TxTypes_1.TxTypes.Trade:
+            case TxTypes_1.TxTypes.Phantasma: {
+                w.writeArrayBlob(this.witnesses);
+                break;
+            }
+            case TxTypes_1.TxTypes.Phantasma_Raw: {
+                if (this.witnesses.length !== 0)
+                    throw new Error('No witnesses expected');
+                break;
+            }
+            default:
+                throw new Error('Unsupported transaction type');
+        }
+    }
+    read(r) {
+        this.msg = TxMsg_1.TxMsg.read(r);
+        this.witnesses = [];
+        switch (this.msg.type) {
+            case TxTypes_1.TxTypes.TransferFungible:
+            case TxTypes_1.TxTypes.TransferNonFungible_Single:
+            case TxTypes_1.TxTypes.TransferNonFungible_Multi:
+            case TxTypes_1.TxTypes.MintFungible:
+            case TxTypes_1.TxTypes.BurnFungible:
+            case TxTypes_1.TxTypes.MintNonFungible:
+            case TxTypes_1.TxTypes.BurnNonFungible: {
+                const sig = Bytes64_1.Bytes64.read(r);
+                this.witnesses = [new Witness_1.Witness(this.msg.gasFrom, sig)];
+                break;
+            }
+            case TxTypes_1.TxTypes.TransferFungible_GasPayer:
+            case TxTypes_1.TxTypes.TransferNonFungible_Single_GasPayer:
+            case TxTypes_1.TxTypes.TransferNonFungible_Multi_GasPayer:
+            case TxTypes_1.TxTypes.BurnFungible_GasPayer:
+            case TxTypes_1.TxTypes.BurnNonFungible_GasPayer: {
+                const sig0 = Bytes64_1.Bytes64.read(r);
+                const sig1 = Bytes64_1.Bytes64.read(r);
+                // "from" resolution depends on concrete message type; omitted here
+                this.witnesses = [new Witness_1.Witness(this.msg.gasFrom, sig0), new Witness_1.Witness(Bytes32_1.Bytes32.Empty, sig1)];
+                throw new Error('Unsupported transaction type');
+                break;
+            }
+            case TxTypes_1.TxTypes.Call:
+            case TxTypes_1.TxTypes.Call_Multi:
+            case TxTypes_1.TxTypes.Trade:
+            case TxTypes_1.TxTypes.Phantasma: {
+                this.witnesses = r.readArrayBlob(Witness_1.Witness);
+                break;
+            }
+            case TxTypes_1.TxTypes.Phantasma_Raw:
+                this.witnesses = [];
+                break;
+            default:
+                throw new Error('Unsupported transaction type');
+        }
+    }
+    static read(r) {
+        const v = new SignedTxMsg();
+        v.read(r);
+        return v;
+    }
+}
+exports.SignedTxMsg = SignedTxMsg;

package/dist/core/types/Carbon/Blockchain/TxHelpers/CreateTokenSeriesTxHelper.d.ts

@@ -0,0 +1,16 @@
+import { PhantasmaKeys } from '../../../PhantasmaKeys';
+import { Bytes32 } from '../../Bytes32';
+import { SeriesInfo } from '../Modules';
+import { TxMsg } from '../TxMsg';
+import { CreateSeriesFeeOptions } from './FeeOptions';
+export declare class CreateTokenSeriesTxHelper {
+    /** Build a Tx without signing. */
+    static buildTx(tokenId: bigint, // ulong
+    seriesInfo: SeriesInfo, creatorPublicKey: Bytes32, feeOptions?: CreateSeriesFeeOptions, maxData?: bigint, expiry?: bigint): TxMsg;
+    /** Build and sign, returning raw bytes. */
+    static buildTxAndSign(tokenId: bigint, seriesInfo: SeriesInfo, signer: PhantasmaKeys, feeOptions?: CreateSeriesFeeOptions, maxData?: bigint, expiry?: bigint): Uint8Array;
+    /** Build, sign and return hex string. */
+    static buildTxAndSignHex(tokenId: bigint, seriesInfo: SeriesInfo, signer: PhantasmaKeys, feeOptions?: CreateSeriesFeeOptions, maxData?: bigint, expiry?: bigint): string;
+    static parseResult(resultHex: string): number;
+}
+//# sourceMappingURL=CreateTokenSeriesTxHelper.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxHelpers/CreateTokenSeriesTxHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateTokenSeriesTxHelper.d.ts","sourceRoot":"","sources":["../../../../../../src/core/types/Carbon/Blockchain/TxHelpers/CreateTokenSeriesTxHelper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAE,UAAU,EAAyB,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,qBAAa,yBAAyB;IACpC,kCAAkC;IAClC,MAAM,CAAC,OAAO,CACZ,OAAO,EAAE,MAAM,EAAE,QAAQ;IACzB,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,OAAO,EACzB,UAAU,CAAC,EAAE,sBAAsB,EACnC,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,KAAK;IA0BR,2CAA2C;IAC3C,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,sBAAsB,EACnC,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,UAAU;IAYb,yCAAyC;IACzC,MAAM,CAAC,iBAAiB,CACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,sBAAsB,EACnC,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;IAMT,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAK9C"}

package/dist/core/types/Carbon/Blockchain/TxHelpers/CreateTokenSeriesTxHelper.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateTokenSeriesTxHelper = void 0;
+const utils_1 = require("../../../../utils");
+const CarbonSerialization_1 = require("../../../CarbonSerialization");
+const Bytes32_1 = require("../../Bytes32");
+const SmallString_1 = require("../../SmallString");
+const TxTypes_1 = require("../../TxTypes");
+const TxMsgSigner_1 = require("../Extensions/TxMsgSigner");
+const ModuleId_1 = require("../ModuleId");
+const Modules_1 = require("../Modules");
+const TxMsg_1 = require("../TxMsg");
+const TxMsgCall_1 = require("../TxMsgCall");
+const FeeOptions_1 = require("./FeeOptions");
+class CreateTokenSeriesTxHelper {
+    /** Build a Tx without signing. */
+    static buildTx(tokenId, // ulong
+    seriesInfo, creatorPublicKey, feeOptions, maxData, expiry) {
+        const fees = feeOptions ?? new FeeOptions_1.CreateSeriesFeeOptions();
+        const maxGas = fees.calculateMaxGas();
+        const argsW = new CarbonSerialization_1.CarbonBinaryWriter();
+        argsW.write8(tokenId);
+        seriesInfo.write(argsW);
+        // --- Tx message: Call(Token.CreateTokenSeries, args) ---
+        const msg = new TxMsg_1.TxMsg();
+        msg.type = TxTypes_1.TxTypes.Call;
+        msg.expiry = expiry || BigInt(Date.now() + 60000);
+        msg.maxGas = maxGas;
+        msg.maxData = maxData;
+        msg.gasFrom = creatorPublicKey;
+        msg.payload = SmallString_1.SmallString.empty;
+        const call = new TxMsgCall_1.TxMsgCall();
+        call.moduleId = ModuleId_1.ModuleId.Token;
+        call.methodId = Modules_1.TokenContract_Methods.CreateTokenSeries;
+        call.args = argsW.toUint8Array();
+        msg.msg = call;
+        return msg;
+    }
+    /** Build and sign, returning raw bytes. */
+    static buildTxAndSign(tokenId, seriesInfo, signer, feeOptions, maxData, expiry) {
+        const tx = this.buildTx(tokenId, seriesInfo, new Bytes32_1.Bytes32(signer.PublicKey), feeOptions, maxData, expiry);
+        return TxMsgSigner_1.TxMsgSigner.signAndSerialize(tx, signer);
+    }
+    /** Build, sign and return hex string. */
+    static buildTxAndSignHex(tokenId, seriesInfo, signer, feeOptions, maxData, expiry) {
+        return (0, utils_1.bytesToHex)(this.buildTxAndSign(tokenId, seriesInfo, signer, feeOptions, maxData, expiry));
+    }
+    static parseResult(resultHex) {
+        // UInt32 carbon seriesId
+        const r = new CarbonSerialization_1.CarbonBinaryReader((0, utils_1.hexToBytes)(resultHex));
+        return r.read4u();
+    }
+}
+exports.CreateTokenSeriesTxHelper = CreateTokenSeriesTxHelper;

package/dist/core/types/Carbon/Blockchain/TxHelpers/CreateTokenTxHelper.d.ts

@@ -0,0 +1,12 @@
+import { PhantasmaKeys } from '../../../PhantasmaKeys';
+import { Bytes32 } from '../../Bytes32';
+import { TokenInfo } from '../Modules';
+import { TxMsg } from '../TxMsg';
+import { CreateTokenFeeOptions } from './FeeOptions';
+export declare class CreateTokenTxHelper {
+    static buildTx(tokenInfo: TokenInfo, creatorPublicKey: Bytes32, feeOptions?: CreateTokenFeeOptions, maxData?: bigint, expiry?: bigint): TxMsg;
+    static buildTxAndSign(tokenInfo: TokenInfo, signer: PhantasmaKeys, feeOptions?: CreateTokenFeeOptions, maxData?: bigint, expiry?: bigint): Uint8Array;
+    static buildTxAndSignHex(tokenInfo: TokenInfo, signer: PhantasmaKeys, feeOptions?: CreateTokenFeeOptions, maxData?: bigint, expiry?: bigint): string;
+    static parseResult(resultHex: string): number;
+}
+//# sourceMappingURL=CreateTokenTxHelper.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxHelpers/CreateTokenTxHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateTokenTxHelper.d.ts","sourceRoot":"","sources":["../../../../../../src/core/types/Carbon/Blockchain/TxHelpers/CreateTokenTxHelper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAKxC,OAAO,EAAyB,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CACZ,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,OAAO,EACzB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,KAAK;IAwBR,MAAM,CAAC,cAAc,CACnB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,UAAU;IAKb,MAAM,CAAC,iBAAiB,CACtB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;IAKT,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAK9C"}

package/dist/core/types/Carbon/Blockchain/TxHelpers/CreateTokenTxHelper.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateTokenTxHelper = void 0;
+const utils_1 = require("../../../../utils");
+const CarbonSerialization_1 = require("../../../CarbonSerialization");
+const Bytes32_1 = require("../../Bytes32");
+const SmallString_1 = require("../../SmallString");
+const TxTypes_1 = require("../../TxTypes");
+const TxMsgSigner_1 = require("../Extensions/TxMsgSigner");
+const ModuleId_1 = require("../ModuleId");
+const Modules_1 = require("../Modules");
+const TxMsg_1 = require("../TxMsg");
+const TxMsgCall_1 = require("../TxMsgCall");
+const FeeOptions_1 = require("./FeeOptions");
+class CreateTokenTxHelper {
+    static buildTx(tokenInfo, creatorPublicKey, feeOptions, maxData, expiry) {
+        const fees = feeOptions ?? new FeeOptions_1.CreateTokenFeeOptions();
+        const maxGas = fees.calculateMaxGas(tokenInfo.symbol);
+        const msg = new TxMsg_1.TxMsg();
+        msg.type = TxTypes_1.TxTypes.Call;
+        msg.expiry = expiry || BigInt(Date.now() + 60000);
+        msg.maxGas = maxGas;
+        msg.maxData = maxData;
+        msg.gasFrom = creatorPublicKey;
+        msg.payload = SmallString_1.SmallString.empty;
+        const argsW = new CarbonSerialization_1.CarbonBinaryWriter();
+        tokenInfo.write(argsW);
+        const call = new TxMsgCall_1.TxMsgCall();
+        call.moduleId = ModuleId_1.ModuleId.Token;
+        call.methodId = Modules_1.TokenContract_Methods.CreateToken;
+        call.args = argsW.toUint8Array();
+        msg.msg = call;
+        return msg;
+    }
+    static buildTxAndSign(tokenInfo, signer, feeOptions, maxData, expiry) {
+        const tx = this.buildTx(tokenInfo, new Bytes32_1.Bytes32(signer.PublicKey), feeOptions, maxData, expiry);
+        return TxMsgSigner_1.TxMsgSigner.signAndSerialize(tx, signer);
+    }
+    static buildTxAndSignHex(tokenInfo, signer, feeOptions, maxData, expiry) {
+        const bytes = this.buildTxAndSign(tokenInfo, signer, feeOptions, maxData, expiry);
+        return (0, utils_1.bytesToHex)(bytes);
+    }
+    static parseResult(resultHex) {
+        // UInt32 carbon tokenId
+        const r = new CarbonSerialization_1.CarbonBinaryReader((0, utils_1.hexToBytes)(resultHex));
+        return r.read4u();
+    }
+}
+exports.CreateTokenTxHelper = CreateTokenTxHelper;

package/dist/core/types/Carbon/Blockchain/TxHelpers/FeeOptions.d.ts

@@ -0,0 +1,31 @@
+/** Common interface for fee option. */
+export interface IFeeOptions {
+    feeMultiplier: bigint;
+    calculateMaxGas(...args: unknown[]): bigint;
+}
+/** Base fee options with sensible defaults. */
+export declare class FeeOptions implements IFeeOptions {
+    gasFeeBase: bigint;
+    feeMultiplier: bigint;
+    constructor(gasFeeBase?: bigint, feeMultiplier?: bigint);
+    calculateMaxGas(..._args: unknown[]): bigint;
+}
+/** Fee options for token creation transactions. */
+export declare class CreateTokenFeeOptions extends FeeOptions implements IFeeOptions {
+    gasFeeCreateTokenBase: bigint;
+    gasFeeCreateTokenSymbol: bigint;
+    constructor(gasFeeBase?: bigint, gasFeeCreateTokenBase?: bigint, gasFeeCreateTokenSymbol?: bigint, feeMultiplier?: bigint);
+    calculateMaxGas(...args: unknown[]): bigint;
+}
+/** Fee options for creating a new series on an NFT token. */
+export declare class CreateSeriesFeeOptions extends FeeOptions implements IFeeOptions {
+    gasFeeCreateSeriesBase: bigint;
+    constructor(gasFeeBase?: bigint, gasFeeCreateSeriesBase?: bigint, feeMultiplier?: bigint);
+    calculateMaxGas(..._args: unknown[]): bigint;
+}
+/** Fee options for minting non-fungible tokens (NFT instances). */
+export declare class MintNftFeeOptions extends FeeOptions implements IFeeOptions {
+    constructor(gasFeeBase?: bigint, feeMultiplier?: bigint);
+    calculateMaxGas(..._args: unknown[]): bigint;
+}
+//# sourceMappingURL=FeeOptions.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxHelpers/FeeOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeeOptions.d.ts","sourceRoot":"","sources":["../../../../../../src/core/types/Carbon/Blockchain/TxHelpers/FeeOptions.ts"],"names":[],"mappings":"AAEA,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;CAC7C;AAED,+CAA+C;AAC/C,qBAAa,UAAW,YAAW,WAAW;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;gBAEV,UAAU,GAAE,MAAgB,EAAE,aAAa,GAAE,MAAe;IAKxE,eAAe,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM;CAG7C;AAED,mDAAmD;AACnD,qBAAa,qBAAsB,SAAQ,UAAW,YAAW,WAAW;IAC1E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;gBAG9B,UAAU,GAAE,MAAgB,EAC5B,qBAAqB,GAAE,MAAwB,EAC/C,uBAAuB,GAAE,MAAwB,EACjD,aAAa,GAAE,MAAgB;IAOxB,eAAe,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM;CAWrD;AAED,6DAA6D;AAC7D,qBAAa,sBAAuB,SAAQ,UAAW,YAAW,WAAW;IAC3E,sBAAsB,EAAE,MAAM,CAAC;gBAG7B,UAAU,GAAE,MAAgB,EAC5B,sBAAsB,GAAE,MAAuB,EAC/C,aAAa,GAAE,MAAgB;IAMxB,eAAe,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM;CAGtD;AAED,mEAAmE;AACnE,qBAAa,iBAAkB,SAAQ,UAAW,YAAW,WAAW;gBAC1D,UAAU,GAAE,MAAgB,EAAE,aAAa,GAAE,MAAe;IAI/D,eAAe,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM;CAGtD"}

package/dist/core/types/Carbon/Blockchain/TxHelpers/FeeOptions.js

@@ -0,0 +1,56 @@
+"use strict";
+// namespace PhantasmaPhoenix.Protocol.Carbon.Blockchain.TxHelpers
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MintNftFeeOptions = exports.CreateSeriesFeeOptions = exports.CreateTokenFeeOptions = exports.FeeOptions = void 0;
+/** Base fee options with sensible defaults. */
+class FeeOptions {
+    constructor(gasFeeBase = 10000n, feeMultiplier = 1000n) {
+        this.gasFeeBase = gasFeeBase;
+        this.feeMultiplier = feeMultiplier;
+    }
+    calculateMaxGas(..._args) {
+        return this.gasFeeBase * this.feeMultiplier;
+    }
+}
+exports.FeeOptions = FeeOptions;
+/** Fee options for token creation transactions. */
+class CreateTokenFeeOptions extends FeeOptions {
+    constructor(gasFeeBase = 10000n, gasFeeCreateTokenBase = 10000000000n, gasFeeCreateTokenSymbol = 10000000000n, feeMultiplier = 10000n) {
+        super(gasFeeBase, feeMultiplier);
+        this.gasFeeCreateTokenBase = gasFeeCreateTokenBase;
+        this.gasFeeCreateTokenSymbol = gasFeeCreateTokenSymbol;
+    }
+    calculateMaxGas(...args) {
+        let symbol = '';
+        if (args.length > 0 && typeof args[0] === 'object' && args[0] !== null && 'data' in args[0]) {
+            const s = args[0];
+            symbol = s.data;
+        }
+        const symbolLen = symbol.length;
+        const shift = symbolLen > 0 ? BigInt(symbolLen - 1) : 0n;
+        const symbolCost = this.gasFeeCreateTokenSymbol >> shift;
+        return (this.gasFeeBase + this.gasFeeCreateTokenBase + symbolCost) * this.feeMultiplier;
+    }
+}
+exports.CreateTokenFeeOptions = CreateTokenFeeOptions;
+/** Fee options for creating a new series on an NFT token. */
+class CreateSeriesFeeOptions extends FeeOptions {
+    constructor(gasFeeBase = 10000n, gasFeeCreateSeriesBase = 2500000000n, feeMultiplier = 10000n) {
+        super(gasFeeBase, feeMultiplier);
+        this.gasFeeCreateSeriesBase = gasFeeCreateSeriesBase;
+    }
+    calculateMaxGas(..._args) {
+        return (this.gasFeeBase + this.gasFeeCreateSeriesBase) * this.feeMultiplier;
+    }
+}
+exports.CreateSeriesFeeOptions = CreateSeriesFeeOptions;
+/** Fee options for minting non-fungible tokens (NFT instances). */
+class MintNftFeeOptions extends FeeOptions {
+    constructor(gasFeeBase = 10000n, feeMultiplier = 1000n) {
+        super(gasFeeBase, feeMultiplier);
+    }
+    calculateMaxGas(..._args) {
+        return this.gasFeeBase * this.feeMultiplier;
+    }
+}
+exports.MintNftFeeOptions = MintNftFeeOptions;

package/dist/core/types/Carbon/Blockchain/TxHelpers/MintNonFungibleTxHelper.d.ts

@@ -0,0 +1,10 @@
+import { PhantasmaKeys } from '../../../PhantasmaKeys';
+import { Bytes32 } from '../../Bytes32';
+import { TxMsg } from '../TxMsg';
+import { MintNftFeeOptions } from './FeeOptions';
+export declare class MintNonFungibleTxHelper {
+    static buildTx(carbonTokenId: bigint, carbonSeriesId: number, senderPublicKey: Bytes32, receiverPublicKey: Bytes32, rom: Uint8Array, ram: Uint8Array, feeOptions?: MintNftFeeOptions, maxData?: bigint, expiry?: bigint): TxMsg;
+    static buildTxAndSign(tokenId: bigint, seriesId: number, signer: PhantasmaKeys, receiverPublicKey: Bytes32, rom: Uint8Array, ram: Uint8Array, feeOptions?: MintNftFeeOptions, maxData?: bigint, expiry?: bigint): Uint8Array;
+    static buildTxAndSignHex(tokenId: bigint, seriesId: number, signer: PhantasmaKeys, receiverPublicKey: Bytes32, rom: Uint8Array, ram: Uint8Array | null | undefined, feeOptions?: MintNftFeeOptions, maxData?: bigint, expiry?: bigint): string;
+}
+//# sourceMappingURL=MintNonFungibleTxHelper.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxHelpers/MintNonFungibleTxHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MintNonFungibleTxHelper.d.ts","sourceRoot":"","sources":["../../../../../../src/core/types/Carbon/Blockchain/TxHelpers/MintNonFungibleTxHelper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qBAAa,uBAAuB;IAElC,MAAM,CAAC,OAAO,CACZ,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,OAAO,EACxB,iBAAiB,EAAE,OAAO,EAC1B,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,EACf,UAAU,CAAC,EAAE,iBAAiB,EAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,KAAK;IAyBR,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,EACrB,iBAAiB,EAAE,OAAO,EAC1B,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,EACf,UAAU,CAAC,EAAE,iBAAiB,EAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,UAAU;IAiBb,MAAM,CAAC,iBAAiB,CACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,EACrB,iBAAiB,EAAE,OAAO,EAC1B,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EAClC,UAAU,CAAC,EAAE,iBAAiB,EAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;CAcV"}

package/dist/core/types/Carbon/Blockchain/TxHelpers/MintNonFungibleTxHelper.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MintNonFungibleTxHelper = void 0;
+const utils_1 = require("../../../../utils");
+const Bytes32_1 = require("../../Bytes32");
+const SmallString_1 = require("../../SmallString");
+const TxTypes_1 = require("../../TxTypes");
+const TxMsgSigner_1 = require("../Extensions/TxMsgSigner");
+const TxMsg_1 = require("../TxMsg");
+const TxMsgMintNonFungible_1 = require("../TxMsgMintNonFungible");
+const FeeOptions_1 = require("./FeeOptions");
+class MintNonFungibleTxHelper {
+    // Build a Tx without signing
+    static buildTx(carbonTokenId, carbonSeriesId, senderPublicKey, receiverPublicKey, rom, ram, feeOptions, maxData, expiry) {
+        const fees = feeOptions ?? new FeeOptions_1.MintNftFeeOptions();
+        const maxGas = fees.calculateMaxGas();
+        const msg = new TxMsg_1.TxMsg();
+        msg.type = TxTypes_1.TxTypes.MintNonFungible;
+        msg.expiry = expiry || BigInt(Date.now() + 60000);
+        msg.maxGas = maxGas;
+        msg.maxData = maxData;
+        msg.gasFrom = senderPublicKey;
+        msg.payload = SmallString_1.SmallString.empty;
+        let mint = new TxMsgMintNonFungible_1.TxMsgMintNonFungible();
+        mint.tokenId = carbonTokenId;
+        mint.seriesId = carbonSeriesId;
+        mint.to = receiverPublicKey;
+        mint.rom = rom;
+        mint.ram = ram;
+        msg.msg = mint;
+        return msg;
+    }
+    // Build and sign, returning raw bytes
+    static buildTxAndSign(tokenId, seriesId, signer, receiverPublicKey, rom, ram, feeOptions, maxData, expiry) {
+        const senderPub = new Bytes32_1.Bytes32(signer.PublicKey);
+        const tx = this.buildTx(tokenId, seriesId, senderPub, receiverPublicKey, rom, ram, feeOptions, maxData, expiry);
+        return TxMsgSigner_1.TxMsgSigner.signAndSerialize(tx, signer);
+    }
+    // Build, sign and return hex string
+    static buildTxAndSignHex(tokenId, seriesId, signer, receiverPublicKey, rom, ram, feeOptions, maxData, expiry) {
+        const bytes = this.buildTxAndSign(tokenId, seriesId, signer, receiverPublicKey, rom, ram, feeOptions, maxData, expiry);
+        return (0, utils_1.bytesToHex)(bytes);
+    }
+}
+exports.MintNonFungibleTxHelper = MintNonFungibleTxHelper;

package/dist/core/types/Carbon/Blockchain/TxHelpers/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./CreateTokenSeriesTxHelper";
+export * from "./CreateTokenTxHelper";
+export * from "./FeeOptions";
+export * from "./MintNonFungibleTxHelper";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxHelpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/core/types/Carbon/Blockchain/TxHelpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC"}

package/dist/core/types/Carbon/Blockchain/TxHelpers/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CreateTokenSeriesTxHelper"), exports);
+__exportStar(require("./CreateTokenTxHelper"), exports);
+__exportStar(require("./FeeOptions"), exports);
+__exportStar(require("./MintNonFungibleTxHelper"), exports);

package/dist/core/types/Carbon/Blockchain/TxMsg.d.ts

@@ -0,0 +1,24 @@
+import { ICarbonBlob } from '../../../interfaces/Carbon/ICarbonBlob';
+import { CarbonBinaryReader, CarbonBinaryWriter } from '../../CarbonSerialization';
+import { Bytes32 } from '../Bytes32';
+import { SmallString } from '../SmallString';
+import { TxTypes } from '../TxTypes';
+import { TxMsgMintNonFungible } from './TxMsgMintNonFungible';
+import { TxMsgTransferFungible } from './TxMsgTransferFungible';
+export declare class TxMsg implements ICarbonBlob {
+    type?: TxTypes;
+    expiry?: bigint;
+    maxGas?: bigint;
+    maxData?: bigint;
+    gasFrom?: Bytes32;
+    payload?: SmallString;
+    msg?: TxMsgTransferFungible | TxMsgMintNonFungible;
+    constructor(type?: TxTypes, expiry?: bigint, // int64
+    maxGas?: bigint, // uint64
+    maxData?: bigint, // uint64
+    gasFrom?: Bytes32, payload?: SmallString, msg?: TxMsgTransferFungible | TxMsgMintNonFungible);
+    write(w: CarbonBinaryWriter): void;
+    read(r: CarbonBinaryReader): void;
+    static read(r: CarbonBinaryReader): TxMsg;
+}
+//# sourceMappingURL=TxMsg.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxMsg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TxMsg.d.ts","sourceRoot":"","sources":["../../../../../src/core/types/Carbon/Blockchain/TxMsg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qBAAa,KAAM,YAAW,WAAW;IAE9B,IAAI,CAAC,EAAE,OAAO;IACd,MAAM,CAAC,EAAE,MAAM;IACf,MAAM,CAAC,EAAE,MAAM;IACf,OAAO,CAAC,EAAE,MAAM;IAChB,OAAO,CAAC,EAAE,OAAO;IACjB,OAAO,CAAC,EAAE,WAAW;IACrB,GAAG,CAAC,EAAE,qBAAqB,GAAG,oBAAoB;gBANlD,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ;IACzB,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS;IAC3B,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,WAAW,EACrB,GAAG,CAAC,EAAE,qBAAqB,GAAG,oBAAoB;IAI3D,KAAK,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAsBlC,IAAI,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAsBjC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,kBAAkB,GAAG,KAAK;CAK1C"}

package/dist/core/types/Carbon/Blockchain/TxMsg.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TxMsg = void 0;
+const Bytes32_1 = require("../Bytes32");
+const SmallString_1 = require("../SmallString");
+const TxTypes_1 = require("../TxTypes");
+const TxMsgCall_1 = require("./TxMsgCall");
+const TxMsgMintNonFungible_1 = require("./TxMsgMintNonFungible");
+const TxMsgTransferFungible_1 = require("./TxMsgTransferFungible");
+class TxMsg {
+    constructor(type, expiry, // int64
+    maxGas, // uint64
+    maxData, // uint64
+    gasFrom, payload, msg
+    // TODO: Add other message types here
+    ) {
+        this.type = type;
+        this.expiry = expiry;
+        this.maxGas = maxGas;
+        this.maxData = maxData;
+        this.gasFrom = gasFrom;
+        this.payload = payload;
+        this.msg = msg;
+    }
+    write(w) {
+        w.write1(this.type);
+        w.write8(this.expiry);
+        w.write8u(this.maxGas);
+        w.write8u(this.maxData);
+        this.gasFrom.write(w);
+        this.payload.write(w);
+        switch (this.type) {
+            case TxTypes_1.TxTypes.Call:
+                this.msg.write(w);
+                break;
+            case TxTypes_1.TxTypes.TransferFungible:
+                this.msg.write(w);
+                break;
+            case TxTypes_1.TxTypes.MintNonFungible:
+                this.msg.write(w);
+                break;
+            default:
+                throw new Error('Unsupported transaction type');
+        }
+    }
+    read(r) {
+        this.type = r.read1();
+        this.expiry = r.read8();
+        this.maxGas = r.read8u();
+        this.maxData = r.read8u();
+        this.gasFrom = Bytes32_1.Bytes32.read(r);
+        this.payload = SmallString_1.SmallString.read(r);
+        switch (this.type) {
+            case TxTypes_1.TxTypes.Call:
+                this.msg = TxMsgCall_1.TxMsgCall.read(r);
+                break;
+            case TxTypes_1.TxTypes.TransferFungible:
+                this.msg = TxMsgTransferFungible_1.TxMsgTransferFungible.read(r);
+                break;
+            case TxTypes_1.TxTypes.MintNonFungible:
+                this.msg = TxMsgMintNonFungible_1.TxMsgMintNonFungible.read(r);
+                break;
+            default:
+                throw new Error('Unsupported transaction type');
+        }
+    }
+    static read(r) {
+        const v = new TxMsg();
+        v.read(r);
+        return v;
+    }
+}
+exports.TxMsg = TxMsg;

package/dist/core/types/Carbon/Blockchain/TxMsgCall.d.ts

@@ -0,0 +1,12 @@
+import { ICarbonBlob } from '../../../interfaces/Carbon/ICarbonBlob';
+import { CarbonBinaryReader, CarbonBinaryWriter } from '../../CarbonSerialization';
+export declare class TxMsgCall implements ICarbonBlob {
+    moduleId: number;
+    methodId: number;
+    args: Uint8Array;
+    constructor(moduleId?: number, methodId?: number, args?: Uint8Array);
+    write(w: CarbonBinaryWriter): void;
+    read(r: CarbonBinaryReader): void;
+    static read(r: CarbonBinaryReader): TxMsgCall;
+}
+//# sourceMappingURL=TxMsgCall.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxMsgCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TxMsgCall.d.ts","sourceRoot":"","sources":["../../../../../src/core/types/Carbon/Blockchain/TxMsgCall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEnF,qBAAa,SAAU,YAAW,WAAW;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;gBAEL,QAAQ,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAU,EAAE,IAAI,GAAE,UAA6B;IAM3F,KAAK,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAMlC,IAAI,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAMjC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,kBAAkB,GAAG,SAAS;CAK9C"}

package/dist/core/types/Carbon/Blockchain/TxMsgCall.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TxMsgCall = void 0;
+class TxMsgCall {
+    constructor(moduleId = 0, methodId = 0, args = new Uint8Array()) {
+        this.moduleId = moduleId >>> 0;
+        this.methodId = methodId >>> 0;
+        this.args = args;
+    }
+    write(w) {
+        w.write4u(this.moduleId);
+        w.write4u(this.methodId);
+        w.writeArray(this.args);
+    }
+    read(r) {
+        this.moduleId = r.read4u();
+        this.methodId = r.read4u();
+        this.args = r.readArray();
+    }
+    static read(r) {
+        const v = new TxMsgCall();
+        v.read(r);
+        return v;
+    }
+}
+exports.TxMsgCall = TxMsgCall;

package/dist/core/types/Carbon/Blockchain/TxMsgMintNonFungible.d.ts

@@ -0,0 +1,15 @@
+import { ICarbonBlob } from '../../../interfaces/Carbon/ICarbonBlob';
+import { CarbonBinaryReader, CarbonBinaryWriter } from '../../CarbonSerialization';
+import { Bytes32 } from '../Bytes32';
+export declare class TxMsgMintNonFungible implements ICarbonBlob {
+    tokenId: bigint;
+    to: Bytes32;
+    seriesId: number;
+    rom: Uint8Array;
+    ram: Uint8Array;
+    constructor(init?: Partial<TxMsgMintNonFungible>);
+    write(w: CarbonBinaryWriter): void;
+    read(r: CarbonBinaryReader): void;
+    static read(r: CarbonBinaryReader): TxMsgMintNonFungible;
+}
+//# sourceMappingURL=TxMsgMintNonFungible.d.ts.map

package/dist/core/types/Carbon/Blockchain/TxMsgMintNonFungible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TxMsgMintNonFungible.d.ts","sourceRoot":"","sources":["../../../../../src/core/types/Carbon/Blockchain/TxMsgMintNonFungible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,qBAAa,oBAAqB,YAAW,WAAW;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;gBAEJ,IAAI,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAShD,KAAK,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAQlC,IAAI,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAQjC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,kBAAkB,GAAG,oBAAoB;CAKzD"}