@getomnichain/omnichain 0.5.0 → 0.6.0

package/dist/esm/stellar/stellar_wallet.js

@@ -0,0 +1,190 @@
+import { createHmac } from 'node:crypto';
+import { Keypair, Operation, StrKey } from '@stellar/stellar-sdk';
+import { mnemonicToSeedSep5 } from "../bip39.js";
+import { ChainType, WalletFamily } from "../chain_type.js";
+import { ChainError, ChainErrorKinds } from "../errors.js";
+import { pyTypeRepr } from "../python_repr.js";
+import { AbstractBip32StyleSingleAccountWallet } from "../wallet.base.js";
+import { stellarSdkAsset } from "./stellar_asset.js";
+import { StellarChain, StellarSignedMessage, stellarMessageHash } from "./stellar_chain.js";
+import { StellarChangeTrustLineTransactionPrerequisite, StellarChangeTrustPrerequisiteResponse, StellarSignedTransaction, StellarUnsignedTransaction, stellarOperationAmount, } from "./stellar_transactions.js";
+const STELLAR_DERIVATION_PATH_REGEX = /^m\/44'\/148'\/(\d+)'$/;
+const SLIP10_ED25519_SEED_MODIFIER = 'ed25519 seed';
+const FIRST_HARDENED_INDEX = 0x80000000;
+export function deriveSep5Ed25519Seed(bip39Seed, index) {
+    let digest = createHmac('sha512', SLIP10_ED25519_SEED_MODIFIER).update(bip39Seed.subarray(0, 64)).digest();
+    let il = digest.subarray(0, 32);
+    let ir = digest.subarray(32);
+    for (const segment of [44, 148, index]) {
+        const indexBytes = Buffer.alloc(4);
+        indexBytes.writeUInt32BE(FIRST_HARDENED_INDEX + segment);
+        digest = createHmac('sha512', ir).update(Buffer.concat([Buffer.alloc(1), il, indexBytes])).digest();
+        il = digest.subarray(0, 32);
+        ir = digest.subarray(32);
+    }
+    return Buffer.from(il);
+}
+export class StellarWallet extends AbstractBip32StyleSingleAccountWallet {
+    #secretSeed;
+    #keypair;
+    _address;
+    constructor(secretSeed) {
+        super();
+        if (!StrKey.isValidEd25519SecretSeed(secretSeed)) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, 'Invalid Stellar secret seed');
+        }
+        this.#secretSeed = secretSeed;
+        this.#keypair = Keypair.fromSecret(secretSeed);
+        this._address = this.#keypair.publicKey();
+    }
+    get secretSeed() {
+        return this.#secretSeed;
+    }
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return `StellarWallet { address: '${this._address}' }`;
+    }
+    static chainType() {
+        return ChainType.STELLAR;
+    }
+    static walletFamily() {
+        return WalletFamily.STELLAR;
+    }
+    chainType() {
+        return StellarWallet.chainType();
+    }
+    walletFamily() {
+        return StellarWallet.walletFamily();
+    }
+    get address() {
+        return this._address;
+    }
+    get publicKey() {
+        return this.#keypair.publicKey();
+    }
+    static fromSecret(secretSeed) {
+        return new StellarWallet(secretSeed);
+    }
+    static fromMnemonic(mnemonicStr, opts = {}) {
+        const derivationPath = opts.derivationPath ?? "m/44'/148'/0'";
+        const passphrase = opts.passphrase ?? '';
+        const index = StellarWallet._indexFromDerivationPath(derivationPath);
+        const rawEd25519Seed = deriveSep5Ed25519Seed(mnemonicToSeedSep5(mnemonicStr, passphrase), index);
+        return new StellarWallet(Keypair.fromRawEd25519Seed(rawEd25519Seed).secret());
+    }
+    static derivationPath(args = {}) {
+        const purpose = args.purpose ?? 44;
+        const coinType = args.coinType ?? 148;
+        const change = args.change ?? 0;
+        const index = args.index ?? 0;
+        if (purpose !== 44) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid purpose ${purpose} for Stellar BIP44, expected 44.`);
+        }
+        if (coinType !== 148) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid coin_type ${coinType} for Stellar, expected 148.`);
+        }
+        if (change !== 0) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Stellar derivation does not use the change level (got ${change}).`);
+        }
+        if (index !== 0) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Stellar derivation does not use the index level (got ${index}); use account instead.`);
+        }
+        return `m/44'/148'/${args.account ?? 0}'`;
+    }
+    static _indexFromDerivationPath(derivationPath) {
+        const match = STELLAR_DERIVATION_PATH_REGEX.exec(derivationPath);
+        if (match === null) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid Stellar derivation path: ${derivationPath}, expected m/44'/148'/<index>'`);
+        }
+        return Number.parseInt(match[1], 10);
+    }
+    async ensureMinimumTrustLine(chain, code, issuer, limit) {
+        const asset = chain.createSacToken(code, issuer);
+        const currentLimit = await chain.getTrustLineLimit(this.address, asset);
+        if (currentLimit.limit.gte(limit)) {
+            return null;
+        }
+        const changeTrustOp = Operation.changeTrust({
+            asset: stellarSdkAsset(code, issuer),
+            limit: stellarOperationAmount(limit, 'limit', { allowZero: true }),
+        });
+        const unsignedTx = new StellarUnsignedTransaction({
+            chainId: chain.chainId,
+            sourceAccountId: this.address,
+            operations: [changeTrustOp],
+        });
+        const signedTx = await this.signTransaction(unsignedTx, chain);
+        return chain.broadcastSignedTransaction(signedTx);
+    }
+    async closeTrustLine(chain, code, issuer) {
+        const asset = chain.createSacToken(code, issuer);
+        const currentLimit = await chain.getTrustLineLimit(this.address, asset);
+        if (!currentLimit.balance.isZero()) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Wallet ${this.address} has still balance of ${currentLimit.balance.toString()} ${code}, Removing trustline requires zero balance. Either swap this token to XLM or send it back to the issuer.`, { chainId: chain.chainId, address: this.address });
+        }
+        const changeTrustOp = Operation.changeTrust({ asset: stellarSdkAsset(code, issuer), limit: '0' });
+        const unsignedTx = new StellarUnsignedTransaction({
+            chainId: chain.chainId,
+            sourceAccountId: this.address,
+            operations: [changeTrustOp],
+        });
+        const signedTx = await this.signTransaction(unsignedTx, chain);
+        return chain.broadcastSignedTransaction(signedTx);
+    }
+    async handleTransactionPrerequisite(prerequisite, chain) {
+        if (prerequisite instanceof StellarChangeTrustLineTransactionPrerequisite) {
+            const stellarChain = assertStellarChain(chain);
+            if (prerequisite.chainId !== stellarChain.chainId) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid chain with id ${stellarChain.chainId} for handling prerequisite ${String(prerequisite)} with chain id ${prerequisite.chainId}`, { chainId: stellarChain.chainId });
+            }
+            if (prerequisite.walletAddress !== this.address) {
+                const asset = stellarChain.createSacToken(prerequisite.code, prerequisite.issuer);
+                const currentLimit = await stellarChain.getTrustLineLimit(prerequisite.walletAddress, asset);
+                if (currentLimit.limit.lt(prerequisite.limit)) {
+                    throw new ChainError(ChainErrorKinds.InvalidArgument, `Prerequisite not handled and does not belong to Stellar wallet ${this.address}, so it cannot behandled. Prerequisite ${String(prerequisite)} of type ${pyTypeRepr(prerequisite)}`, { chainId: stellarChain.chainId });
+                }
+            }
+            if (prerequisite.walletAddress !== this.address) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `Stellar wallet ${this.address} cannot handle trustline prerequisite for ${prerequisite.walletAddress}`, { chainId: stellarChain.chainId });
+            }
+            const response = await this.ensureMinimumTrustLine(stellarChain, prerequisite.code, prerequisite.issuer, prerequisite.limit);
+            if (response === null) {
+                return new StellarChangeTrustPrerequisiteResponse({ skipped: true, txHash: null });
+            }
+            return new StellarChangeTrustPrerequisiteResponse({ skipped: false, txHash: response.txHash });
+        }
+        throw new ChainError(ChainErrorKinds.FeatureNotSupported, `Unsupported prerequisite ${String(prerequisite)} of type ${pyTypeRepr(prerequisite)}, expected StellarChangeTrustTransactionPrerequisite.`);
+    }
+    async signTransaction(transaction, chain) {
+        if (!(transaction instanceof StellarUnsignedTransaction)) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid transaction ${String(transaction)}, expected StellarUnsignedTransaction.`);
+        }
+        const stellarChain = assertStellarChain(chain);
+        const envelope = await transaction.buildTransactionEnvelope(stellarChain);
+        envelope.sign(this.#keypair);
+        return new StellarSignedTransaction({
+            chainId: stellarChain.chainId,
+            signedXdr: envelope.toXDR(),
+            networkPassphrase: stellarChain.networkPassphrase,
+        });
+    }
+    async requestTestnetFaucetStroops() {
+        const response = await fetch(`https://friendbot.stellar.org/?addr=${this.address}`);
+        if (!response.ok) {
+            throw new ChainError(ChainErrorKinds.RpcError, `Friendbot request failed with HTTP ${response.status}`, { address: this.address });
+        }
+        return response.json();
+    }
+    signMessage(message) {
+        return new StellarSignedMessage(this.#keypair.sign(stellarMessageHash(message)).toString('hex'));
+    }
+    verifySignature(message, signedMessage) {
+        return StellarChain.verifySignature(this.publicKey, message, signedMessage);
+    }
+}
+function assertStellarChain(chain) {
+    if (!(chain instanceof StellarChain)) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Invalid chain ${String(chain)}, expected StellarChain`);
+    }
+    return chain;
+}
+//# sourceMappingURL=stellar_wallet.js.map

package/dist/esm/stellar/stellar_wallet.js.map

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

package/dist/esm/token.d.ts

@@ -1,4 +1,5 @@
 export declare abstract class Token {
+    protected static readonly allowsEmptySymbol: boolean;
     readonly chainId: number;
     readonly symbol: string;
     readonly identifier?: string;

package/dist/esm/token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../token.ts"],"names":[],"mappings":"AAEA,8BAAsB,KAAK;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,SAAS,aACP,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM;IAoBlB,QAAQ,IAAI,OAAO;IAInB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAQ7B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAInC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAIhC,QAAQ,IAAI,MAAM;CAGnB"}
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../token.ts"],"names":[],"mappings":"AAEA,8BAAsB,KAAK;IACzB,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAS;IAE7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,SAAS,aACP,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM;IAqBlB,QAAQ,IAAI,OAAO;IAInB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAQ7B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAInC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAIhC,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/esm/token.js

@@ -1,5 +1,6 @@
 import { ChainError, ChainErrorKinds } from "./errors.js";
 export class Token {
+    static allowsEmptySymbol = false;
     chainId;
     symbol;
     identifier;
@@ -8,7 +9,8 @@ export class Token {
         if (!Number.isInteger(chainId)) {
             throw new ChainError(ChainErrorKinds.InvalidArgument, 'Token chainId must be an integer');
         }
-        if (!symbol) {
+        const emptySymbolAllowed = symbol === '' && new.target.allowsEmptySymbol;
+        if (!symbol && !emptySymbolAllowed) {
             throw new ChainError(ChainErrorKinds.InvalidArgument, 'Token symbol is required');
         }
         if (!Number.isInteger(decimals) || decimals < 0) {

package/dist/esm/token.js.map

@@ -1 +1 @@
-{"version":3,"file":"token.js","sourceRoot":"","sources":["../../token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,OAAgB,KAAK;IAChB,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,UAAU,CAAU;IACpB,QAAQ,CAAS;IAE1B,YACE,OAAe,EACf,MAAc,EACd,UAA8B,EAC9B,QAAgB;QAEhB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,kCAAkC,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,0BAA0B,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,+CAA+C,CAChD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAY;QACjB,OAAO,CACL,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAC9B,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAC5B,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CACrC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAY;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAY;QACpB,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CAAC;IAChF,CAAC;IAED,QAAQ;QACN,OAAO,iBAAiB,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,MAAM,gBAAgB,IAAI,CAAC,UAAU,IAAI,QAAQ,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC;IACvI,CAAC;CACF"}
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,OAAgB,KAAK;IACf,MAAM,CAAU,iBAAiB,GAAY,KAAK,CAAC;IAEpD,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,UAAU,CAAU;IACpB,QAAQ,CAAS;IAE1B,YACE,OAAe,EACf,MAAc,EACd,UAA8B,EAC9B,QAAgB;QAEhB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,kCAAkC,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,kBAAkB,GAAG,MAAM,KAAK,EAAE,IAAK,GAAG,CAAC,MAAoD,CAAC,iBAAiB,CAAC;QACxH,IAAI,CAAC,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACnC,MAAM,IAAI,UAAU,CAAC,eAAe,CAAC,eAAe,EAAE,0BAA0B,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,+CAA+C,CAChD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAY;QACjB,OAAO,CACL,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAC9B,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAC5B,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CACrC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAY;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAY;QACpB,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CAAC;IAChF,CAAC;IAED,QAAQ;QACN,OAAO,iBAAiB,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,MAAM,gBAAgB,IAAI,CAAC,UAAU,IAAI,QAAQ,cAAc,IAAI,CAAC,QAAQ,GAAG,CAAC;IACvI,CAAC"}

package/dist/esm/transaction_json.d.ts

@@ -0,0 +1,21 @@
+export type JsonDict = Record<string, unknown>;
+export type JsonTransactionInput = string | Uint8Array | JsonDict;
+export declare const JSON_TRANSACTION_TYPE_KEY = "type";
+export declare const JSON_TRANSACTION_CHAIN_ID_KEY = "chain_id";
+export interface JsonTransactionClass {
+    readonly name: string;
+    readonly JSON_TYPE: string;
+    readonly prototype: object;
+    fromJson(data: JsonTransactionInput): unknown;
+}
+export declare function registerJsonTransactionType(cls: JsonTransactionClass): void;
+export declare function registeredJsonTransactionTypes(): string[];
+export declare function coerceJsonDict(data: JsonTransactionInput): JsonDict;
+export declare function jsonTransactionEnvelope(type: string, chainId: number, fields: JsonDict): JsonDict;
+export declare function parseJsonTransactionEnvelope(data: JsonTransactionInput, expectedType: string): JsonDict;
+export declare function jsonPayloadItem(payload: JsonDict, key: string): unknown;
+export declare function transactionFromJson(base: {
+    readonly name: string;
+    readonly prototype: object;
+}, rootFromJson: (data: JsonTransactionInput) => unknown, data: JsonTransactionInput): unknown;
+//# sourceMappingURL=transaction_json.d.ts.map

package/dist/esm/transaction_json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_json.d.ts","sourceRoot":"","sources":["../../transaction_json.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElE,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,6BAA6B,aAAa,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC;CAC/C;AAID,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAS3E;AAED,wBAAgB,8BAA8B,IAAI,MAAM,EAAE,CAEzD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAkBnE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAMjG;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,GAAG,QAAQ,CAavG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3D,YAAY,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,EACrD,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAuBT"}

package/dist/esm/transaction_json.js

@@ -0,0 +1,75 @@
+import { ChainError, ChainErrorKinds } from "./errors.js";
+import { pyRepr, pyTypeName } from "./python_repr.js";
+export const JSON_TRANSACTION_TYPE_KEY = 'type';
+export const JSON_TRANSACTION_CHAIN_ID_KEY = 'chain_id';
+const jsonTransactionRegistry = new Map();
+export function registerJsonTransactionType(cls) {
+    const registered = jsonTransactionRegistry.get(cls.JSON_TYPE);
+    if (registered !== undefined && registered !== cls) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Duplicate transaction JSON type ${pyRepr(cls.JSON_TYPE)}: already registered by ${registered.name}`);
+    }
+    jsonTransactionRegistry.set(cls.JSON_TYPE, cls);
+}
+export function registeredJsonTransactionTypes() {
+    return [...jsonTransactionRegistry.keys()].sort();
+}
+export function coerceJsonDict(data) {
+    let value = data;
+    try {
+        if (typeof data === 'string') {
+            value = JSON.parse(data);
+        }
+        else if (data instanceof Uint8Array) {
+            value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(data));
+        }
+    }
+    catch (err) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, err.message, {}, err);
+    }
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Expected a JSON object (dict) or its serialized form, got ${pyTypeName(value)}`);
+    }
+    return value;
+}
+export function jsonTransactionEnvelope(type, chainId, fields) {
+    return {
+        [JSON_TRANSACTION_TYPE_KEY]: type,
+        [JSON_TRANSACTION_CHAIN_ID_KEY]: chainId,
+        ...fields,
+    };
+}
+export function parseJsonTransactionEnvelope(data, expectedType) {
+    const payload = coerceJsonDict(data);
+    const type = payload[JSON_TRANSACTION_TYPE_KEY];
+    if (type !== expectedType) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Cannot deserialize a ${pyRepr(type)} payload as ${expectedType}`);
+    }
+    if (!(JSON_TRANSACTION_CHAIN_ID_KEY in payload)) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `${expectedType} payload is missing a ${pyRepr(JSON_TRANSACTION_CHAIN_ID_KEY)} field`);
+    }
+    return payload;
+}
+export function jsonPayloadItem(payload, key) {
+    if (!(key in payload))
+        throw new ChainError(ChainErrorKinds.InvalidArgument, pyRepr(key));
+    return payload[key];
+}
+export function transactionFromJson(base, rootFromJson, data) {
+    const payload = coerceJsonDict(data);
+    const type = payload[JSON_TRANSACTION_TYPE_KEY];
+    if (typeof type !== 'string') {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Transaction JSON payload is missing a ${pyRepr(JSON_TRANSACTION_TYPE_KEY)} field: ${pyRepr(payload)}`);
+    }
+    const target = jsonTransactionRegistry.get(type);
+    if (target === undefined) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `Unknown transaction JSON type ${pyRepr(type)}. Known types: ${pyRepr(registeredJsonTransactionTypes())}`);
+    }
+    if (target !== base && !(target.prototype instanceof base)) {
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `${type} is not a ${base.name}, cannot deserialize it as one`);
+    }
+    if (target.fromJson === rootFromJson) {
+        throw new ChainError(ChainErrorKinds.FeatureNotSupported, `${target.name} does not implement from_json()`);
+    }
+    return target.fromJson(payload);
+}
+//# sourceMappingURL=transaction_json.js.map

package/dist/esm/transaction_json.js.map

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

package/dist/esm/transaction_prerequisite.d.ts

@@ -0,0 +1,17 @@
+import { UnsignedTransaction } from './unsigned_transaction.ts';
+export declare abstract class AbstractTransactionPrerequisite {
+    abstract get chainId(): number;
+}
+export declare abstract class AbstractHandledPrerequisiteResponse {
+    abstract get skipped(): boolean;
+}
+export interface UnsignedTransactionWithPrerequisitesInit<T extends UnsignedTransaction, P extends AbstractTransactionPrerequisite> {
+    prerequisites: P[];
+    transaction: T;
+}
+export declare class UnsignedTransactionWithPrerequisites<T extends UnsignedTransaction = UnsignedTransaction, P extends AbstractTransactionPrerequisite = AbstractTransactionPrerequisite> {
+    readonly prerequisites: P[];
+    readonly transaction: T;
+    constructor(init: UnsignedTransactionWithPrerequisitesInit<T, P>);
+}
+//# sourceMappingURL=transaction_prerequisite.d.ts.map

package/dist/esm/transaction_prerequisite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_prerequisite.d.ts","sourceRoot":"","sources":["../../transaction_prerequisite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,8BAAsB,+BAA+B;IACnD,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC;CAChC;AAED,8BAAsB,mCAAmC;IACvD,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wCAAwC,CACvD,CAAC,SAAS,mBAAmB,EAC7B,CAAC,SAAS,+BAA+B;IAEzC,aAAa,EAAE,CAAC,EAAE,CAAC;IACnB,WAAW,EAAE,CAAC,CAAC;CAChB;AAED,qBAAa,oCAAoC,CAC/C,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,EACnD,CAAC,SAAS,+BAA+B,GAAG,+BAA+B;IAE3E,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;gBAEZ,IAAI,EAAE,wCAAwC,CAAC,CAAC,EAAE,CAAC,CAAC;CAIjE"}

package/dist/esm/transaction_prerequisite.js

@@ -0,0 +1,13 @@
+export class AbstractTransactionPrerequisite {
+}
+export class AbstractHandledPrerequisiteResponse {
+}
+export class UnsignedTransactionWithPrerequisites {
+    prerequisites;
+    transaction;
+    constructor(init) {
+        this.prerequisites = init.prerequisites;
+        this.transaction = init.transaction;
+    }
+}
+//# sourceMappingURL=transaction_prerequisite.js.map

package/dist/esm/transaction_prerequisite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_prerequisite.js","sourceRoot":"","sources":["../../transaction_prerequisite.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,+BAA+B;CAEpD;AAED,MAAM,OAAgB,mCAAmC;CAExD;AAUD,MAAM,OAAO,oCAAoC;IAItC,aAAa,CAAM;IACnB,WAAW,CAAI;IAExB,YAAY,IAAoD;QAC9D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;CACF"}

package/dist/esm/transaction_simulation.d.ts

@@ -0,0 +1,20 @@
+import { NestedBalanceChanges } from './transaction_status.ts';
+export declare const TransactionSimulationStatusTypes: {
+    readonly Success: "Success";
+    readonly Failed: "Failed";
+};
+export type TransactionSimulationStatusType = (typeof TransactionSimulationStatusTypes)[keyof typeof TransactionSimulationStatusTypes];
+export interface TransactionSimulationResultInit {
+    chainId: number;
+    statusType: TransactionSimulationStatusType;
+    balanceChanges: NestedBalanceChanges;
+    error: Error | null;
+}
+export declare abstract class AbstractTransactionSimulationResult {
+    readonly chainId: number;
+    readonly statusType: TransactionSimulationStatusType;
+    readonly balanceChanges: NestedBalanceChanges;
+    readonly error: Error | null;
+    protected constructor(init: TransactionSimulationResultInit);
+}
+//# sourceMappingURL=transaction_simulation.d.ts.map

package/dist/esm/transaction_simulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_simulation.d.ts","sourceRoot":"","sources":["../../transaction_simulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,gCAAgC;;;CAGnC,CAAC;AAEX,MAAM,MAAM,+BAA+B,GACzC,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,OAAO,gCAAgC,CAAC,CAAC;AAE3F,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,+BAA+B,CAAC;IAC5C,cAAc,EAAE,oBAAoB,CAAC;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,8BAAsB,mCAAmC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,+BAA+B,CAAC;IACrD,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE7B,SAAS,aAAa,IAAI,EAAE,+BAA+B;CAM5D"}

package/dist/esm/transaction_simulation.js

@@ -0,0 +1,17 @@
+export const TransactionSimulationStatusTypes = {
+    Success: 'Success',
+    Failed: 'Failed',
+};
+export class AbstractTransactionSimulationResult {
+    chainId;
+    statusType;
+    balanceChanges;
+    error;
+    constructor(init) {
+        this.chainId = init.chainId;
+        this.statusType = init.statusType;
+        this.balanceChanges = init.balanceChanges;
+        this.error = init.error;
+    }
+}
+//# sourceMappingURL=transaction_simulation.js.map

package/dist/esm/transaction_simulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction_simulation.js","sourceRoot":"","sources":["../../transaction_simulation.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAYX,MAAM,OAAgB,mCAAmC;IAC9C,OAAO,CAAS;IAChB,UAAU,CAAkC;IAC5C,cAAc,CAAuB;IACrC,KAAK,CAAe;IAE7B,YAAsB,IAAqC;QACzD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF"}

package/dist/esm/tron/index.d.ts

@@ -0,0 +1,16 @@
+export * from './tron_abi.ts';
+export * from './tron_address.ts';
+export * from './tron_assets.ts';
+export * from './tron_asset.ts';
+export * from './tron_canonical_transaction.ts';
+export * from './tron_chains.ts';
+export * from './tron_chain.ts';
+export * from './tron_client.ts';
+export * from './tron_contract.ts';
+export * from './tron_gas_pricing.ts';
+export * from './tron_keys.ts';
+export * from './tron_transaction_builder.ts';
+export * from './tron_transaction_status.ts';
+export * from './tron_transactions.ts';
+export * from './tron_wallet.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/tron/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../tron/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC"}

package/dist/esm/tron/index.js

@@ -0,0 +1,16 @@
+export * from "./tron_abi.js";
+export * from "./tron_address.js";
+export * from "./tron_assets.js";
+export * from "./tron_asset.js";
+export * from "./tron_canonical_transaction.js";
+export * from "./tron_chains.js";
+export * from "./tron_chain.js";
+export * from "./tron_client.js";
+export * from "./tron_contract.js";
+export * from "./tron_gas_pricing.js";
+export * from "./tron_keys.js";
+export * from "./tron_transaction_builder.js";
+export * from "./tron_transaction_status.js";
+export * from "./tron_transactions.js";
+export * from "./tron_wallet.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/tron/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../tron/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC"}

package/dist/esm/tron/tron_abi.d.ts

@@ -0,0 +1,3 @@
+export declare function tronAbiEncodeSingle(typeString: string, values: unknown): string;
+export declare function tronAbiDecodeSingle(typeString: string, data: Uint8Array): unknown;
+//# sourceMappingURL=tron_abi.d.ts.map

package/dist/esm/tron/tron_abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tron_abi.d.ts","sourceRoot":"","sources":["../../../tron/tron_abi.ts"],"names":[],"mappings":"AAYA,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAO/E;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAGjF"}