@explorins/pers-shared 2.1.0

package/dist/cjs/value-objects/signed-tx-data.vo.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignedTransactionDataVo = void 0;
+class SignedTransactionDataVo {
+    _signedTransaction = null;
+    _signedSmartWalletTransaction = null;
+    _chainId;
+    _transactionId;
+    constructor(chainId, transactionId, signedTransaction = null, signedSmartWalletTransaction = null) {
+        // Validation
+        if (!chainId || typeof chainId !== 'number' || chainId <= 0) {
+            throw new Error('Chain ID must be a positive number');
+        }
+        if (!transactionId || typeof transactionId !== 'string' || !transactionId.trim()) {
+            throw new Error('Transaction ID must be a non-empty string');
+        }
+        if (signedTransaction && signedSmartWalletTransaction) {
+            throw new Error('Only one of signedTransaction or signedSmartWalletTransaction should be provided');
+        }
+        if (signedSmartWalletTransaction) {
+            this._signedSmartWalletTransaction = signedSmartWalletTransaction;
+        }
+        else if (signedTransaction) {
+            // Normalize the transaction data (ensure 0x prefix)
+            this._signedTransaction = signedTransaction.startsWith('0x')
+                ? signedTransaction
+                : `0x${signedTransaction}`;
+        }
+        else {
+            throw new Error('Signed transaction must be a non-empty');
+        }
+        this._transactionId = transactionId;
+        this._chainId = chainId;
+    }
+    // Getters
+    get signedTransaction() {
+        return this._signedTransaction;
+    }
+    get signedSmartWalletTransaction() {
+        return this._signedSmartWalletTransaction;
+    }
+    get chainId() {
+        return this._chainId;
+    }
+    get transactionId() {
+        return this._transactionId;
+    }
+    // Equality comparison
+    equals(other) {
+        return (this.signedTransaction === other.signedTransaction &&
+            this.chainId === other.chainId &&
+            this.transactionId === other.transactionId);
+    }
+    // Create a new instance from plain object data
+    static fromPlainObject(data) {
+        return new SignedTransactionDataVo(data.chainId, data.transactionId, data.signedTransaction, data.signedSmartWalletTransaction);
+    }
+    // Convert to plain object (useful for serialization)
+    toPlainObject() {
+        return {
+            signedTransaction: this.signedTransaction,
+            signedSmartWalletTransaction: this.signedSmartWalletTransaction,
+            chainId: this.chainId,
+            transactionId: this.transactionId,
+        };
+    }
+}
+exports.SignedTransactionDataVo = SignedTransactionDataVo;
+//# sourceMappingURL=signed-tx-data.vo.js.map

package/dist/cjs/value-objects/signed-tx-data.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-tx-data.vo.js","sourceRoot":"","sources":["../../../src/value-objects/signed-tx-data.vo.ts"],"names":[],"mappings":";;;AAGA,MAAa,uBAAuB;IACjB,kBAAkB,GAAkB,IAAI,CAAC;IACzC,6BAA6B,GAAuC,IAAI,CAAC;IACzE,QAAQ,CAAS;IACjB,cAAc,CAAS;IAExC,YACE,OAAe,EACf,aAAqB,EACrB,oBAAmC,IAAI,EACvC,+BAAmE,IAAI;QAEvE,aAAa;QAEb,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,IAAG,iBAAiB,IAAI,4BAA4B,EAAC,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACtG,CAAC;QAED,IAAG,4BAA4B,EAAE,CAAC;YAChC,IAAI,CAAC,6BAA6B,GAAG,4BAA4B,CAAC;QACpE,CAAC;aAAM,IAAG,iBAAiB,EAAE,CAAC;YAC5B,oDAAoD;YACpD,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC1D,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,KAAK,iBAAiB,EAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAE1B,CAAC;IAED,UAAU;IACV,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,IAAI,4BAA4B;QAC9B,OAAO,IAAI,CAAC,6BAA6B,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,sBAAsB;IACtB,MAAM,CAAC,KAA8B;QACnC,OAAO,CACL,IAAI,CAAC,iBAAiB,KAAK,KAAK,CAAC,iBAAiB;YAClD,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAC9B,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa,CAC3C,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,MAAM,CAAC,eAAe,CAAC,IAKtB;QACC,OAAO,IAAI,uBAAuB,CAEhC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,4BAA4B,CAClC,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,aAAa;QAMX,OAAO;YACL,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,4BAA4B,EAAE,IAAI,CAAC,4BAA4B;YAC/D,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;CACF;AAlGD,0DAkGC"}

package/dist/cjs/value-objects/token-balance.value-object.d.ts

@@ -0,0 +1,90 @@
+import { NativeTokenType } from '../types/native-token.type';
+import { Address } from './address.value-object';
+/**
+ * Value object representing the token balance details.
+ */
+export declare class TokenBalance {
+    private readonly chainId;
+    private readonly smartContractAddress;
+    private readonly tokenId;
+    private readonly metadataUri;
+    private readonly balance;
+    private readonly tokenName;
+    private readonly tokenSymbol;
+    private readonly tokenType;
+    /**
+     * Constructs a new TokenBalance value object.
+     *
+     * @param {number} chainId - The chain ID of the blockchain.
+     * @param {Address} smartContractAddress - The smart contract address of the token.
+     * @param {string | null} tokenId - The ID of the token (can be null for certain token types).
+     * @param {number} balance - The balance of the token.
+     * @param {string} metadataUri - The URI of the token (optional).
+     * @param {string} tokenName - The name of the token.
+     * @param {string} tokenSymbol - The symbol of the token.
+     * @param {NativeTokenType} tokenType - The type of the token (e.g., ERC20, ERC721).
+     */
+    constructor(chainId: number, smartContractAddress: Address, tokenId: string | null | undefined, metadataUri: string | null | undefined, balance: number, tokenName: string, tokenSymbol: string, tokenType: NativeTokenType);
+    /**
+     * Gets the chain ID.
+     *
+     * @returns {number} The chain ID.
+     */
+    getChainId(): number;
+    /**
+     * Gets the smart contract address.
+     *
+     * @returns {Address} The smart contract address.
+     */
+    getSmartContractAddress(): Address;
+    /**
+     * Gets the token ID.
+     *
+     * @returns {string | null} The token ID (or null if not applicable).
+     */
+    getTokenId(): string | null;
+    /**
+     * Gets the token URI.
+     *
+     * @returns {string | null} The token URI (or null if not applicable).
+     */
+    getMetadataUri(): string | null;
+    /**
+     * Gets the balance of the token.
+     *
+     * @returns {number} The token balance.
+     */
+    getBalance(): number;
+    /**
+     * Gets the name of the token.
+     *
+     * @returns {string} The name of the token.
+     */
+    getTokenName(): string;
+    /**
+     * Gets the symbol of the token.
+     *
+     * @returns {string} The symbol of the token.
+     */
+    getTokenSymbol(): string;
+    /**
+     * Gets the type of the token.
+     *
+     * @returns {NativeTokenType} The type of the token (e.g., ERC20, ERC721).
+     */
+    getTokenType(): NativeTokenType;
+    /**
+     * Returns a string representation of the TokenBalance.
+     *
+     * @returns {string} A formatted string showing the token balance parameters.
+     */
+    toString(): string;
+    /**
+     * Compares this TokenBalance with another TokenBalance instance for equality.
+     *
+     * @param {TokenBalance} other - The other TokenBalance instance to compare with.
+     * @returns {boolean} True if the two instances are equal, false otherwise.
+     */
+    equals(other: TokenBalance): boolean;
+}
+//# sourceMappingURL=token-balance.value-object.d.ts.map

package/dist/cjs/value-objects/token-balance.value-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-balance.value-object.d.ts","sourceRoot":"","sources":["../../../src/value-objects/token-balance.value-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C;;;;;;;;;;;OAWG;gBAEC,OAAO,EAAE,MAAM,EACf,oBAAoB,EAAE,OAAO,EAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,YAAO,EAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,YAAO,EACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe;IAa9B;;;;OAIG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;OAIG;IACI,uBAAuB,IAAI,OAAO;IAIzC;;;;OAIG;IACI,UAAU,IAAI,MAAM,GAAG,IAAI;IAIlC;;;;OAIG;IACI,cAAc,IAAI,MAAM,GAAG,IAAI;IAItC;;;;OAIG;IACI,UAAU,IAAI,MAAM;IAI3B;;;;OAIG;IACI,YAAY,IAAI,MAAM;IAI7B;;;;OAIG;IACI,cAAc,IAAI,MAAM;IAI/B;;;;OAIG;IACI,YAAY,IAAI,eAAe;IAItC;;;;OAIG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;CAS9C"}

package/dist/cjs/value-objects/token-balance.value-object.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenBalance = void 0;
+/**
+ * Value object representing the token balance details.
+ */
+class TokenBalance {
+    chainId;
+    smartContractAddress;
+    tokenId;
+    metadataUri;
+    balance;
+    tokenName;
+    tokenSymbol;
+    tokenType;
+    /**
+     * Constructs a new TokenBalance value object.
+     *
+     * @param {number} chainId - The chain ID of the blockchain.
+     * @param {Address} smartContractAddress - The smart contract address of the token.
+     * @param {string | null} tokenId - The ID of the token (can be null for certain token types).
+     * @param {number} balance - The balance of the token.
+     * @param {string} metadataUri - The URI of the token (optional).
+     * @param {string} tokenName - The name of the token.
+     * @param {string} tokenSymbol - The symbol of the token.
+     * @param {NativeTokenType} tokenType - The type of the token (e.g., ERC20, ERC721).
+     */
+    constructor(chainId, smartContractAddress, tokenId = null, metadataUri = null, balance, tokenName, tokenSymbol, tokenType // = NativeTokenType.ERC20 // Default value set to ERC20
+    ) {
+        this.chainId = chainId;
+        this.smartContractAddress = smartContractAddress;
+        this.tokenId = tokenId;
+        this.metadataUri = metadataUri;
+        this.balance = balance;
+        this.tokenName = tokenName;
+        this.tokenSymbol = tokenSymbol;
+        this.tokenType = tokenType;
+    }
+    /**
+     * Gets the chain ID.
+     *
+     * @returns {number} The chain ID.
+     */
+    getChainId() {
+        return this.chainId;
+    }
+    /**
+     * Gets the smart contract address.
+     *
+     * @returns {Address} The smart contract address.
+     */
+    getSmartContractAddress() {
+        return this.smartContractAddress;
+    }
+    /**
+     * Gets the token ID.
+     *
+     * @returns {string | null} The token ID (or null if not applicable).
+     */
+    getTokenId() {
+        return this.tokenId;
+    }
+    /**
+     * Gets the token URI.
+     *
+     * @returns {string | null} The token URI (or null if not applicable).
+     */
+    getMetadataUri() {
+        return this.metadataUri;
+    }
+    /**
+     * Gets the balance of the token.
+     *
+     * @returns {number} The token balance.
+     */
+    getBalance() {
+        return this.balance;
+    }
+    /**
+     * Gets the name of the token.
+     *
+     * @returns {string} The name of the token.
+     */
+    getTokenName() {
+        return this.tokenName;
+    }
+    /**
+     * Gets the symbol of the token.
+     *
+     * @returns {string} The symbol of the token.
+     */
+    getTokenSymbol() {
+        return this.tokenSymbol;
+    }
+    /**
+     * Gets the type of the token.
+     *
+     * @returns {NativeTokenType} The type of the token (e.g., ERC20, ERC721).
+     */
+    getTokenType() {
+        return this.tokenType;
+    }
+    /**
+     * Returns a string representation of the TokenBalance.
+     *
+     * @returns {string} A formatted string showing the token balance parameters.
+     */
+    toString() {
+        return `TokenBalance: [ChainId: ${this.chainId}, SmartContract: ${this.smartContractAddress.getValue()}, TokenId: ${this.tokenId}, Balance: ${this.balance}, TokenName: ${this.tokenName}, TokenSymbol: ${this.tokenSymbol}, TokenType: ${this.tokenType}]`;
+    }
+    /**
+     * Compares this TokenBalance with another TokenBalance instance for equality.
+     *
+     * @param {TokenBalance} other - The other TokenBalance instance to compare with.
+     * @returns {boolean} True if the two instances are equal, false otherwise.
+     */
+    equals(other) {
+        return this.chainId === other.getChainId() &&
+            this.smartContractAddress.equals(other.getSmartContractAddress()) &&
+            this.tokenId === other.getTokenId() &&
+            this.balance === other.getBalance() &&
+            this.tokenName === other.getTokenName() &&
+            this.tokenSymbol === other.getTokenSymbol() &&
+            this.tokenType === other.getTokenType();
+    }
+}
+exports.TokenBalance = TokenBalance;
+//# sourceMappingURL=token-balance.value-object.js.map

package/dist/cjs/value-objects/token-balance.value-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-balance.value-object.js","sourceRoot":"","sources":["../../../src/value-objects/token-balance.value-object.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,MAAa,YAAY;IACJ,OAAO,CAAS;IAChB,oBAAoB,CAAU;IAC9B,OAAO,CAAgB;IACvB,WAAW,CAAgB;IAC3B,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,SAAS,CAAkB;IAE5C;;;;;;;;;;;OAWG;IACH,YACI,OAAe,EACf,oBAA6B,EAC7B,UAAyB,IAAI,EAC7B,cAA6B,IAAI,EACjC,OAAe,EACf,SAAiB,EACjB,WAAmB,EACnB,SAA0B,CAAC,wDAAwD;;QAGnF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACI,uBAAuB;QAC1B,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACI,cAAc;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACI,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,cAAc;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACX,OAAO,2BAA2B,IAAI,CAAC,OAAO,oBAAoB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,cAAc,IAAI,CAAC,OAAO,cAAc,IAAI,CAAC,OAAO,gBAAgB,IAAI,CAAC,SAAS,kBAAkB,IAAI,CAAC,WAAW,gBAAgB,IAAI,CAAC,SAAS,GAAG,CAAC;IAChQ,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAmB;QAC7B,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,EAAE;YACtC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC;YACjE,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,EAAE;YACnC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,UAAU,EAAE;YACnC,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,YAAY,EAAE;YACvC,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,cAAc,EAAE;YAC3C,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;IAChD,CAAC;CACJ;AA3ID,oCA2IC"}

package/dist/cjs/value-objects/token-transaction-entity-reference-input.vo.d.ts

@@ -0,0 +1,45 @@
+import { Web3TransactionType } from '../enum/transaction-type.enum';
+import { TransactionActor } from '../interfaces/transaction-actor.interface';
+/**
+ * Token Transaction Entity Reference Input VO
+ *
+ * Sequential pipeline input for transaction processing:
+ * Any Module → Transaction Module → Web3 Module
+ *
+ * Uses only entity references (IDs) - Transaction Module resolves:
+ * - tokenEntityId → contract address, ABI, and chain ID (based on environment)
+ * - sender/recipient actors → wallet addresses
+ */
+export declare class TokenTransactionEntityReferenceInputVo {
+    transactionId: string | null;
+    readonly tokenEntityId: string;
+    /**
+     * Represents the token ID for ERC1155 or other standards.
+     * For ERC721 minting operations, this field should contain the unique token URI.
+     */
+    contractTokenId: string | null;
+    readonly sender: TransactionActor;
+    readonly recipient: TransactionActor | null;
+    readonly amount: number;
+    readonly type: Web3TransactionType;
+    readonly aiPrompt?: string;
+    readonly fallbackImageUri?: string;
+    readonly overrideTokenName?: string;
+    readonly overrideTokenDescription?: string;
+    readonly customAttributes?: Record<string, any>;
+    constructor(data: {
+        transactionId?: string | null;
+        tokenEntityId: string;
+        contractTokenId?: string | null;
+        sender: TransactionActor;
+        recipient?: TransactionActor | null;
+        amount: number;
+        type: Web3TransactionType;
+        aiPrompt?: string;
+        fallbackImageUri?: string;
+        overrideTokenName?: string;
+        overrideTokenDescription?: string;
+        customAttributes?: Record<string, any>;
+    });
+}
+//# sourceMappingURL=token-transaction-entity-reference-input.vo.d.ts.map

package/dist/cjs/value-objects/token-transaction-entity-reference-input.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-transaction-entity-reference-input.vo.d.ts","sourceRoot":"","sources":["../../../src/value-objects/token-transaction-entity-reference-input.vo.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAE7E;;;;;;;;;GASG;AACH,qBAAa,sCAAsC;IAGjD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAEgB,aAAa,EAAE,MAAM,CAAC;IAEtC;;;OAGG;IAGI,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,SAIgB,MAAM,EAAE,gBAAgB,CAAC;IAEzC,SAIgB,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEnD,SAEgB,MAAM,EAAE,MAAM,CAAC;IAE/B,SAEgB,IAAI,EAAE,mBAAmB,CAAC;IAG1C,SAEgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1C,SAEgB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3C,SAEgB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElD,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAE3C,IAAI,EAAE;QAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,MAAM,EAAE,gBAAgB,CAAC;QACzB,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,mBAAmB,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACxC;CA2BF"}

package/dist/cjs/value-objects/token-transaction-entity-reference-input.vo.js

@@ -0,0 +1,137 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenTransactionEntityReferenceInputVo = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const transaction_type_enum_1 = require("../enum/transaction-type.enum");
+/**
+ * Token Transaction Entity Reference Input VO
+ *
+ * Sequential pipeline input for transaction processing:
+ * Any Module → Transaction Module → Web3 Module
+ *
+ * Uses only entity references (IDs) - Transaction Module resolves:
+ * - tokenEntityId → contract address, ABI, and chain ID (based on environment)
+ * - sender/recipient actors → wallet addresses
+ */
+class TokenTransactionEntityReferenceInputVo {
+    transactionId;
+    tokenEntityId; // Reference to token entity - resolves to contract, ABI, and chainId
+    /**
+     * Represents the token ID for ERC1155 or other standards.
+     * For ERC721 minting operations, this field should contain the unique token URI.
+     */
+    contractTokenId;
+    sender; // TransactionActor instead of string
+    recipient; // TransactionActor instead of string
+    amount;
+    type;
+    // Optional fields for AI-driven ERC721 metadata generation
+    aiPrompt;
+    fallbackImageUri;
+    overrideTokenName;
+    overrideTokenDescription;
+    customAttributes;
+    constructor(data) {
+        this.transactionId = data.transactionId || null;
+        this.tokenEntityId = data.tokenEntityId;
+        this.contractTokenId = data.contractTokenId || null;
+        this.sender = data.sender;
+        this.recipient = data.recipient || null;
+        this.amount = data.amount;
+        this.type = data.type;
+        // Assign optional fields
+        this.aiPrompt = data.aiPrompt;
+        this.fallbackImageUri = data.fallbackImageUri;
+        this.overrideTokenName = data.overrideTokenName;
+        this.overrideTokenDescription = data.overrideTokenDescription;
+        this.customAttributes = data.customAttributes;
+        // Basic validation
+        if (this.amount <= 0 && this.type) {
+            throw new Error('Transaction amount must be positive for this transaction type.');
+        }
+        if (!this.sender) {
+            throw new Error('Sender actor is required.');
+        }
+        if (this.type !== transaction_type_enum_1.Web3TransactionType.BURN && (!this.recipient)) {
+            throw new Error('Recipient actor is required for this transaction type.');
+        }
+    }
+}
+exports.TokenTransactionEntityReferenceInputVo = TokenTransactionEntityReferenceInputVo;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], TokenTransactionEntityReferenceInputVo.prototype, "transactionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], TokenTransactionEntityReferenceInputVo.prototype, "tokenEntityId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], TokenTransactionEntityReferenceInputVo.prototype, "contractTokenId", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => Object) // TransactionActor is an interface
+    ,
+    __metadata("design:type", Object)
+], TokenTransactionEntityReferenceInputVo.prototype, "sender", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => Object) // TransactionActor is an interface
+    ,
+    __metadata("design:type", Object)
+], TokenTransactionEntityReferenceInputVo.prototype, "recipient", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", Number)
+], TokenTransactionEntityReferenceInputVo.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(transaction_type_enum_1.Web3TransactionType),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], TokenTransactionEntityReferenceInputVo.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], TokenTransactionEntityReferenceInputVo.prototype, "aiPrompt", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], TokenTransactionEntityReferenceInputVo.prototype, "fallbackImageUri", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], TokenTransactionEntityReferenceInputVo.prototype, "overrideTokenName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], TokenTransactionEntityReferenceInputVo.prototype, "overrideTokenDescription", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], TokenTransactionEntityReferenceInputVo.prototype, "customAttributes", void 0);
+//# sourceMappingURL=token-transaction-entity-reference-input.vo.js.map

package/dist/cjs/value-objects/token-transaction-entity-reference-input.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-transaction-entity-reference-input.vo.js","sourceRoot":"","sources":["../../../src/value-objects/token-transaction-entity-reference-input.vo.ts"],"names":[],"mappings":"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"}

package/dist/cjs/value-objects/token-transaction-input.vo.d.ts

@@ -0,0 +1,28 @@
+import type { ContractAbi } from 'web3';
+import { Web3TransactionType } from '../enum/transaction-type.enum';
+import { Address } from './address.value-object';
+import { ITokenTransactionInputData } from '../interfaces/token-transaction-input-data.interface';
+import { NativeTokenType } from '../types/native-token.type';
+export declare class TokenTransactionInputDataVo implements ITokenTransactionInputData {
+    transactionId: string | null;
+    readonly chainId: number;
+    readonly smartContractAddress: Address;
+    readonly contractAbi: ContractAbi;
+    /**
+     * Represents the token ID for ERC1155 or other standards.
+     * For ERC721 minting operations, this field should contain the unique token URI.
+     */
+    contractTokenId: string | null;
+    readonly senderAddress: Address;
+    readonly recipientAddress: Address | null;
+    readonly amount: number;
+    readonly type: Web3TransactionType;
+    readonly tokenType: NativeTokenType;
+    readonly aiPrompt?: string;
+    readonly fallbackImageUri?: string;
+    readonly overrideTokenName?: string;
+    readonly overrideTokenDescription?: string;
+    readonly customAttributes?: Record<string, any>;
+    constructor(data: ITokenTransactionInputData);
+}
+//# sourceMappingURL=token-transaction-input.vo.d.ts.map

package/dist/cjs/value-objects/token-transaction-input.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-transaction-input.vo.d.ts","sourceRoot":"","sources":["../../../src/value-objects/token-transaction-input.vo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,qBAAa,2BAA4B,YAAW,0BAA0B;IAG5E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAEgB,OAAO,EAAE,MAAM,CAAC;IAEhC,SAIgB,oBAAoB,EAAE,OAAO,CAAC;IAE9C,SACgB,WAAW,EAAE,WAAW,CAAC;IAEzC;;;OAGG;IAGI,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,SAIgB,aAAa,EAAE,OAAO,CAAC;IAEvC,SAIgB,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjD,SAEgB,MAAM,EAAE,MAAM,CAAC;IAE/B,SAEgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SACgB,SAAS,EAAE,eAAe,CAAC;IAI3C,SAEgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1C,SAEgB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3C,SAEgB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElD,SAEgB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAE3C,IAAI,EAAE,0BAA0B;CA8B7C"}