@hiero-ledger/sdk 2.70.0

package/lib/token/PendingAirdropId.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Represents the identifier for a pending airdrop in the Hedera network.
+ *
+ * A PendingAirdropId contains information about a pending token or NFT airdrop,
+ * including the sender, receiver, and the token or NFT being airdropped. This class
+ * is used to track and identify specific airdrops in the system.
+ */
+export default class PendingAirdropId {
+    /**
+     * @param {HieroProto.proto.PendingAirdropId} pb
+     * @returns {PendingAirdropId}
+     */
+    static fromBytes(pb: HieroProto.proto.PendingAirdropId): PendingAirdropId;
+    /**
+     *
+     * @param {object} props
+     * @param {AccountId} [props.senderId]
+     * @param {AccountId} [props.receiverId]
+     * @param {TokenId?} [props.tokenId]
+     * @param {NftId?} [props.nftId]
+     */
+    constructor(props?: {
+        senderId?: AccountId | undefined;
+        receiverId?: AccountId | undefined;
+        tokenId?: TokenId | null | undefined;
+        nftId?: NftId | null | undefined;
+    });
+    _senderId: AccountId | null;
+    _receiverId: AccountId | null;
+    _tokenId: TokenId | null;
+    _nftId: NftId | null;
+    /**
+     *
+     * @param {AccountId} senderId
+     * @returns {this}
+     */
+    setSenderid(senderId: AccountId): this;
+    /**
+     * @param {AccountId} receiverId
+     * @returns {this}
+     */
+    setReceiverId(receiverId: AccountId): this;
+    /**
+     * @param {TokenId} tokenId
+     * @returns {this}
+     */
+    setTokenId(tokenId: TokenId): this;
+    /**
+     * @param {NftId} nftId
+     * @returns {this}
+     */
+    setNftId(nftId: NftId): this;
+    /**
+     * @returns {?AccountId}
+     */
+    get senderId(): AccountId | null;
+    /**
+     * @returns {?AccountId}
+     */
+    get receiverId(): AccountId | null;
+    /**
+     * @returns {?TokenId}
+     */
+    get tokenId(): TokenId | null;
+    /**
+     * @returns {?NftId}
+     */
+    get nftId(): NftId | null;
+    /**
+     *  @returns {HieroProto.proto.PendingAirdropId}
+     */
+    toBytes(): HieroProto.proto.PendingAirdropId;
+}
+export namespace HieroProto {
+    namespace proto {
+        type PendingAirdropId = import("@hashgraph/proto").proto.PendingAirdropId;
+    }
+}
+import AccountId from "../account/AccountId.js";
+import TokenId from "./TokenId.js";
+import NftId from "./NftId.js";

package/lib/token/PendingAirdropId.js

@@ -0,0 +1,2 @@
+import e from"../account/AccountId.js";import r from"./TokenId.js";import n from"./NftId.js";class t{constructor(e={}){this._senderId=null,this._receiverId=null,this._tokenId=null,this._nftId=null,e.receiverId&&(this._receiverId=e.receiverId),e.senderId&&(this._senderId=e.senderId),e.tokenId?this._tokenId=new r(e.tokenId):e.nftId&&(this._nftId=new n(e.nftId?.tokenId,e.nftId?.serial))}static fromBytes(d){if(null==d.senderId)throw new Error("senderId is required");if(null==d.receiverId)throw new Error("receiverId is required");if(null==d.fungibleTokenType&&null==d.nonFungibleToken)throw new Error("Either fungibleTokenType or nonFungibleToken is required");return new t({senderId:e._fromProtobuf(d.senderId),receiverId:e._fromProtobuf(d.receiverId),nftId:null!=d.nonFungibleToken?n._fromProtobuf(d.nonFungibleToken):null,tokenId:null!=d.fungibleTokenType?r._fromProtobuf(d.fungibleTokenType):null})}setSenderid(e){return this._senderId=e,this}setReceiverId(e){return this._receiverId=e,this}setTokenId(e){return this._nftId=null,this._tokenId=e,this}setNftId(e){return this._tokenId=null,this._nftId=e,this}get senderId(){return this._senderId}get receiverId(){return this._receiverId}get tokenId(){return this._tokenId}get nftId(){return this._nftId}toBytes(){return{senderId:this.senderId?._toProtobuf(),receiverId:this._receiverId?._toProtobuf(),fungibleTokenType:this._tokenId?._toProtobuf(),nonFungibleToken:this._nftId?._toProtobuf()}}}export{t as default};
+//# sourceMappingURL=PendingAirdropId.js.map

package/lib/token/PendingAirdropId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingAirdropId.js","sources":["../../src/token/PendingAirdropId.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n/**\n * @namespace proto\n * @typedef {import(\"@hashgraph/proto\").proto.PendingAirdropId} HieroProto.proto.PendingAirdropId\n */\n\nimport AccountId from \"../account/AccountId.js\";\nimport TokenId from \"./TokenId.js\";\nimport NftId from \"./NftId.js\";\n\n/**\n * Represents the identifier for a pending airdrop in the Hedera network.\n *\n * A PendingAirdropId contains information about a pending token or NFT airdrop,\n * including the sender, receiver, and the token or NFT being airdropped. This class\n * is used to track and identify specific airdrops in the system.\n */\nexport default class PendingAirdropId {\n    /**\n     *\n     * @param {object} props\n     * @param {AccountId} [props.senderId]\n     * @param {AccountId} [props.receiverId]\n     * @param {TokenId?} [props.tokenId]\n     * @param {NftId?} [props.nftId]\n     */\n    constructor(props = {}) {\n        this._senderId = null;\n        this._receiverId = null;\n        this._tokenId = null;\n        this._nftId = null;\n\n        if (props.receiverId) {\n            this._receiverId = props.receiverId;\n        }\n        if (props.senderId) {\n            this._senderId = props.senderId;\n        }\n        if (props.tokenId) {\n            this._tokenId = new TokenId(props.tokenId);\n        } else if (props.nftId) {\n            this._nftId = new NftId(props.nftId?.tokenId, props.nftId?.serial);\n        }\n    }\n\n    /**\n     * @param {HieroProto.proto.PendingAirdropId} pb\n     * @returns {PendingAirdropId}\n     */\n    static fromBytes(pb) {\n        if (pb.senderId == null) {\n            throw new Error(\"senderId is required\");\n        }\n\n        if (pb.receiverId == null) {\n            throw new Error(\"receiverId is required\");\n        }\n\n        if (pb.fungibleTokenType == null && pb.nonFungibleToken == null) {\n            throw new Error(\n                \"Either fungibleTokenType or nonFungibleToken is required\",\n            );\n        }\n\n        return new PendingAirdropId({\n            senderId: AccountId._fromProtobuf(pb.senderId),\n            receiverId: AccountId._fromProtobuf(pb.receiverId),\n            nftId:\n                pb.nonFungibleToken != null\n                    ? NftId._fromProtobuf(pb.nonFungibleToken)\n                    : null,\n            tokenId:\n                pb.fungibleTokenType != null\n                    ? TokenId._fromProtobuf(pb.fungibleTokenType)\n                    : null,\n        });\n    }\n\n    /**\n     *\n     * @param {AccountId} senderId\n     * @returns {this}\n     */\n    setSenderid(senderId) {\n        this._senderId = senderId;\n        return this;\n    }\n\n    /**\n     * @param {AccountId} receiverId\n     * @returns {this}\n     */\n    setReceiverId(receiverId) {\n        this._receiverId = receiverId;\n        return this;\n    }\n\n    /**\n     * @param {TokenId} tokenId\n     * @returns {this}\n     */\n    setTokenId(tokenId) {\n        this._nftId = null;\n        this._tokenId = tokenId;\n        return this;\n    }\n\n    /**\n     * @param {NftId} nftId\n     * @returns {this}\n     */\n    setNftId(nftId) {\n        this._tokenId = null;\n        this._nftId = nftId;\n        return this;\n    }\n\n    /**\n     * @returns {?AccountId}\n     */\n    get senderId() {\n        return this._senderId;\n    }\n\n    /**\n     * @returns {?AccountId}\n     */\n    get receiverId() {\n        return this._receiverId;\n    }\n\n    /**\n     * @returns {?TokenId}\n     */\n    get tokenId() {\n        return this._tokenId;\n    }\n\n    /**\n     * @returns {?NftId}\n     */\n    get nftId() {\n        return this._nftId;\n    }\n\n    /**\n     *  @returns {HieroProto.proto.PendingAirdropId}\n     */\n    toBytes() {\n        return {\n            senderId: this.senderId?._toProtobuf(),\n            receiverId: this._receiverId?._toProtobuf(),\n            fungibleTokenType: this._tokenId?._toProtobuf(),\n            nonFungibleToken: this._nftId?._toProtobuf(),\n        };\n    }\n}\n"],"names":["PendingAirdropId","constructor","props","this","_senderId","_receiverId","_tokenId","_nftId","receiverId","senderId","tokenId","TokenId","nftId","NftId","serial","fromBytes","pb","Error","fungibleTokenType","nonFungibleToken","AccountId","_fromProtobuf","setSenderid","setReceiverId","setTokenId","setNftId","toBytes","_toProtobuf"],"mappings":"6FAiBe,MAAMA,EASjB,WAAAC,CAAYC,EAAQ,IAChBC,KAAKC,UAAY,KACjBD,KAAKE,YAAc,KACnBF,KAAKG,SAAW,KAChBH,KAAKI,OAAS,KAEVL,EAAMM,aACNL,KAAKE,YAAcH,EAAMM,YAEzBN,EAAMO,WACNN,KAAKC,UAAYF,EAAMO,UAEvBP,EAAMQ,QACNP,KAAKG,SAAW,IAAIK,EAAQT,EAAMQ,SAC3BR,EAAMU,QACbT,KAAKI,OAAS,IAAIM,EAAMX,EAAMU,OAAOF,QAASR,EAAMU,OAAOE,QAEvE,CAMI,gBAAOC,CAAUC,GACb,GAAmB,MAAfA,EAAGP,SACH,MAAM,IAAIQ,MAAM,wBAGpB,GAAqB,MAAjBD,EAAGR,WACH,MAAM,IAAIS,MAAM,0BAGpB,GAA4B,MAAxBD,EAAGE,mBAAoD,MAAvBF,EAAGG,iBACnC,MAAM,IAAIF,MACN,4DAIR,OAAO,IAAIjB,EAAiB,CACxBS,SAAUW,EAAUC,cAAcL,EAAGP,UACrCD,WAAYY,EAAUC,cAAcL,EAAGR,YACvCI,MAC2B,MAAvBI,EAAGG,iBACGN,EAAMQ,cAAcL,EAAGG,kBACvB,KACVT,QAC4B,MAAxBM,EAAGE,kBACGP,EAAQU,cAAcL,EAAGE,mBACzB,MAEtB,CAOI,WAAAI,CAAYb,GAER,OADAN,KAAKC,UAAYK,EACVN,IACf,CAMI,aAAAoB,CAAcf,GAEV,OADAL,KAAKE,YAAcG,EACZL,IACf,CAMI,UAAAqB,CAAWd,GAGP,OAFAP,KAAKI,OAAS,KACdJ,KAAKG,SAAWI,EACTP,IACf,CAMI,QAAAsB,CAASb,GAGL,OAFAT,KAAKG,SAAW,KAChBH,KAAKI,OAASK,EACPT,IACf,CAKI,YAAIM,GACA,OAAON,KAAKC,SACpB,CAKI,cAAII,GACA,OAAOL,KAAKE,WACpB,CAKI,WAAIK,GACA,OAAOP,KAAKG,QACpB,CAKI,SAAIM,GACA,OAAOT,KAAKI,MACpB,CAKI,OAAAmB,GACI,MAAO,CACHjB,SAAUN,KAAKM,UAAUkB,cACzBnB,WAAYL,KAAKE,aAAasB,cAC9BT,kBAAmBf,KAAKG,UAAUqB,cAClCR,iBAAkBhB,KAAKI,QAAQoB,cAE3C"}

package/lib/token/PendingAirdropRecord.cjs

@@ -0,0 +1,55 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _long = _interopRequireDefault(require("long"));
+var _PendingAirdropId = _interopRequireDefault(require("./PendingAirdropId.cjs"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.PendingAirdropRecord} HieroProto.proto.PendingAirdropRecord
+ */
+
+class PendingAirdropRecord {
+  /**
+   * @param {object} props
+   * @param {PendingAirdropId} props.airdropId
+   * @param {Long} props.amount
+   */
+  constructor(props) {
+    this.airdropId = props.airdropId;
+    this.amount = props.amount;
+  }
+
+  /**
+   * @returns {HieroProto.proto.PendingAirdropRecord}
+   */
+  toBytes() {
+    return {
+      pendingAirdropId: this.airdropId.toBytes(),
+      pendingAirdropValue: {
+        amount: this.amount
+      }
+    };
+  }
+
+  /**
+   * @param {HieroProto.proto.PendingAirdropRecord} pb
+   * @returns {PendingAirdropRecord}
+   */
+  static fromBytes(pb) {
+    if (pb.pendingAirdropId == null) {
+      throw new Error("pendingAirdropId is required");
+    }
+    const airdropId = _PendingAirdropId.default.fromBytes(pb.pendingAirdropId);
+    const amount = pb.pendingAirdropValue?.amount;
+    return new PendingAirdropRecord({
+      airdropId: airdropId,
+      amount: amount ? amount : _long.default.ZERO
+    });
+  }
+}
+exports.default = PendingAirdropRecord;

package/lib/token/PendingAirdropRecord.d.ts

@@ -0,0 +1,29 @@
+export default class PendingAirdropRecord {
+    /**
+     * @param {HieroProto.proto.PendingAirdropRecord} pb
+     * @returns {PendingAirdropRecord}
+     */
+    static fromBytes(pb: HieroProto.proto.PendingAirdropRecord): PendingAirdropRecord;
+    /**
+     * @param {object} props
+     * @param {PendingAirdropId} props.airdropId
+     * @param {Long} props.amount
+     */
+    constructor(props: {
+        airdropId: PendingAirdropId;
+        amount: Long;
+    });
+    airdropId: PendingAirdropId;
+    amount: Long;
+    /**
+     * @returns {HieroProto.proto.PendingAirdropRecord}
+     */
+    toBytes(): HieroProto.proto.PendingAirdropRecord;
+}
+export namespace HieroProto {
+    namespace proto {
+        type PendingAirdropRecord = import("@hashgraph/proto").proto.PendingAirdropRecord;
+    }
+}
+import PendingAirdropId from "./PendingAirdropId.js";
+import Long from "long";

package/lib/token/PendingAirdropRecord.js

@@ -0,0 +1,2 @@
+import r from"long";import o from"./PendingAirdropId.js";class d{constructor(r){this.airdropId=r.airdropId,this.amount=r.amount}toBytes(){return{pendingAirdropId:this.airdropId.toBytes(),pendingAirdropValue:{amount:this.amount}}}static fromBytes(i){if(null==i.pendingAirdropId)throw new Error("pendingAirdropId is required");const n=o.fromBytes(i.pendingAirdropId),t=i.pendingAirdropValue?.amount;return new d({airdropId:n,amount:t||r.ZERO})}}export{d as default};
+//# sourceMappingURL=PendingAirdropRecord.js.map

package/lib/token/PendingAirdropRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingAirdropRecord.js","sources":["../../src/token/PendingAirdropRecord.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n/**\n * @namespace proto\n * @typedef {import(\"@hashgraph/proto\").proto.PendingAirdropRecord} HieroProto.proto.PendingAirdropRecord\n */\n\nimport Long from \"long\";\nimport PendingAirdropId from \"./PendingAirdropId.js\";\n\nexport default class PendingAirdropRecord {\n    /**\n     * @param {object} props\n     * @param {PendingAirdropId} props.airdropId\n     * @param {Long} props.amount\n     */\n    constructor(props) {\n        this.airdropId = props.airdropId;\n        this.amount = props.amount;\n    }\n\n    /**\n     * @returns {HieroProto.proto.PendingAirdropRecord}\n     */\n    toBytes() {\n        return {\n            pendingAirdropId: this.airdropId.toBytes(),\n            pendingAirdropValue: {\n                amount: this.amount,\n            },\n        };\n    }\n\n    /**\n     * @param {HieroProto.proto.PendingAirdropRecord} pb\n     * @returns {PendingAirdropRecord}\n     */\n    static fromBytes(pb) {\n        if (pb.pendingAirdropId == null) {\n            throw new Error(\"pendingAirdropId is required\");\n        }\n\n        const airdropId = PendingAirdropId.fromBytes(pb.pendingAirdropId);\n        const amount = pb.pendingAirdropValue?.amount;\n\n        return new PendingAirdropRecord({\n            airdropId: airdropId,\n            amount: amount ? amount : Long.ZERO,\n        });\n    }\n}\n"],"names":["PendingAirdropRecord","constructor","props","this","airdropId","amount","toBytes","pendingAirdropId","pendingAirdropValue","fromBytes","pb","Error","PendingAirdropId","Long","ZERO"],"mappings":"yDASe,MAAMA,EAMjB,WAAAC,CAAYC,GACRC,KAAKC,UAAYF,EAAME,UACvBD,KAAKE,OAASH,EAAMG,MAC5B,CAKI,OAAAC,GACI,MAAO,CACHC,iBAAkBJ,KAAKC,UAAUE,UACjCE,oBAAqB,CACjBH,OAAQF,KAAKE,QAG7B,CAMI,gBAAOI,CAAUC,GACb,GAA2B,MAAvBA,EAAGH,iBACH,MAAM,IAAII,MAAM,gCAGpB,MAAMP,EAAYQ,EAAiBH,UAAUC,EAAGH,kBAC1CF,EAASK,EAAGF,qBAAqBH,OAEvC,OAAO,IAAIL,EAAqB,CAC5BI,UAAWA,EACXC,OAAQA,GAAkBQ,EAAKC,MAE3C"}

package/lib/token/TokenAirdropTransaction.cjs

@@ -0,0 +1,179 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Transaction = _interopRequireWildcard(require("../transaction/Transaction.cjs"));
+var _TokenTransfer = _interopRequireDefault(require("./TokenTransfer.cjs"));
+var _TokenNftTransfer = _interopRequireDefault(require("./TokenNftTransfer.cjs"));
+var _AbstractTokenTransferTransaction = _interopRequireDefault(require("./AbstractTokenTransferTransaction.cjs"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.ITokenAirdropTransactionBody} HieroProto.proto.ITokenAirdropTransactionBody
+ * @typedef {import("@hashgraph/proto").proto.ITransaction} HieroProto.proto.ITransaction
+ * @typedef {import("@hashgraph/proto").proto.TransactionID} HieroProto.proto.TransactionID
+ * @typedef {import("@hashgraph/proto").proto.AccountID} HieroProto.proto.AccountID
+ * @typedef {import("@hashgraph/proto").proto.ISignedTransaction} HieroProto.proto.ISignedTransaction
+ * @typedef {import("@hashgraph/proto").proto.ITransactionBody} HieroProto.proto.ITransactionBody
+ * @typedef {import("@hashgraph/proto").proto.TransactionBody} HieroProto.proto.TransactionBody
+ * @typedef {import("@hashgraph/proto").proto.ITransactionResponse} HieroProto.proto.ITransactionResponse
+ */
+
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../transaction/TransactionId.js").default} TransactionId
+ * @typedef {import("../account/AccountId.js").default} AccountId
+ * @typedef {import("./NftId.js").default} NftId
+ * @typedef {import("./TokenId.js").default} TokenId
+ */
+
+/**
+ * Airdrop one or more tokens to one or more accounts.
+ *
+ * ### Effects
+ * This distributes tokens from the balance of one or more sending account(s)
+ * to the balance of one or more recipient accounts. Accounts MAY receive the
+ * tokens in one of four ways.
+ *
+ *  - An account already associated to the token to be distributed SHALL
+ *    receive the airdropped tokens immediately to the recipient account
+ *    balance.<br/>
+ *    The fee for this transfer SHALL include the transfer, the airdrop fee,
+ *    and any custom fees.
+ *  - An account with available automatic association slots SHALL be
+ *    automatically associated to the token, and SHALL immediately receive
+ *    the airdropped tokens to the recipient account balance.<br/>
+ *    The fee for this transfer SHALL include the transfer, the association,
+ *    the cost to renew that association once, the airdrop fee, and
+ *    any custom fees.
+ *  - An account with "receiver signature required" set SHALL have a
+ *    "Pending Airdrop" created and must claim that airdrop with a
+ *    `claimAirdrop` transaction.<br/>
+ *    The fee for this transfer SHALL include the transfer, the association,
+ *    the cost to renew that association once, the airdrop fee, and
+ *    any custom fees.<br/>
+ *    If the pending airdrop is not claimed immediately, the `sender` SHALL
+ *    pay the cost to renew the token association, and the cost to maintain
+ *    the pending airdrop, until the pending airdrop is claimed or cancelled.
+ *  - An account with no available automatic association slots SHALL have a
+ *    "Pending Airdrop" created and must claim that airdrop with a
+ *    `claimAirdrop` transaction.<br/>
+ *    The fee for this transfer SHALL include the transfer, the association,
+ *    the cost to renew that association once, the airdrop fee, and any custom
+ *    fees.<br/>
+ *    If the pending airdrop is not claimed immediately, the `sender` SHALL
+ *    pay the cost to renew the token association, and the cost to maintain
+ *    the pending airdrop, until the pending airdrop is claimed or cancelled.
+ *
+ * If an airdrop would create a pending airdrop for a fungible/common token,
+ * and a pending airdrop for the same sender, receiver, and token already
+ * exists, the existing pending airdrop SHALL be updated to add the new
+ * amount to the existing airdrop, rather than creating
+ * a new pending airdrop.<br/>
+ * Any airdrop that completes immediately SHALL be irreversible. Any airdrop
+ * that results in a "Pending Airdrop" MAY be canceled via a `cancelAirdrop`
+ * transaction.<br/>
+ * All transfer fees (including custom fees and royalties), as well as the
+ * rent cost for the first auto-renewal period for any automatic-association
+ * slot occupied by the airdropped tokens, SHALL be charged to the account
+ * paying for this transaction.<br/>
+ */
+class TokenAirdropTransaction extends _AbstractTokenTransferTransaction.default {
+  /**
+   * @param {object} props
+   * @param {TokenTransfer[]} [props.tokenTransfers]
+   * @param {NftTransfer[]} [props.nftTransfers]
+   */
+  constructor(props = {}) {
+    super();
+    if (props.tokenTransfers != null) {
+      for (const tokenTransfer of props.tokenTransfers) {
+        this._addTokenTransfer(tokenTransfer.tokenId, tokenTransfer.accountId, tokenTransfer.amount, tokenTransfer.isApproved, tokenTransfer.expectedDecimals);
+      }
+    }
+    /**
+     * @private
+     * @type {NftTransfer[]}
+     */
+    this._nftTransfers = [];
+    if (props.nftTransfers != null) {
+      for (const nftTransfer of props.nftTransfers) {
+        this._addNftTransfer(nftTransfer.isApproved, nftTransfer.tokenId, nftTransfer.serialNumber, nftTransfer.senderAccountId, nftTransfer.receiverAccountId);
+      }
+    }
+  }
+
+  /**
+   *
+   * @param {TokenId} tokenId
+   * @param {AccountId} accountId
+   * @param {Long} amount
+   * @param {number} expectedDecimals
+   * @returns {this}
+   */
+  addApprovedTokenTransferWithDecimals(tokenId, accountId, amount, expectedDecimals) {
+    this._requireNotFrozen();
+    this._addTokenTransfer(tokenId, accountId, amount, true, expectedDecimals);
+    return this;
+  }
+
+  /**
+   * @internal
+   * @param {HieroProto.proto.ITransaction[]} transactions
+   * @param {HieroProto.proto.ISignedTransaction[]} signedTransactions
+   * @param {TransactionId[]} transactionIds
+   * @param {AccountId[]} nodeIds
+   * @param {HieroProto.proto.ITransactionBody[]} bodies
+   * @returns {TokenAirdropTransaction}
+   */
+  static _fromProtobuf(transactions, signedTransactions, transactionIds, nodeIds, bodies) {
+    const body = bodies[0];
+    const tokenAirdrop = /** @type {HieroProto.proto.ITokenAirdropTransactionBody} */
+    body.tokenAirdrop;
+    const tokenTransfers = _TokenTransfer.default._fromProtobuf(tokenAirdrop.tokenTransfers ?? []);
+    const nftTransfers = _TokenNftTransfer.default._fromProtobuf(tokenAirdrop.tokenTransfers ?? []);
+    return _Transaction.default._fromProtobufTransactions(new TokenAirdropTransaction({
+      nftTransfers: nftTransfers,
+      tokenTransfers: tokenTransfers
+    }), transactions, signedTransactions, transactionIds, nodeIds, bodies);
+  }
+
+  /**
+   * @override
+   * @internal
+   * @param {Channel} channel
+   * @param {HieroProto.proto.ITransaction} request
+   * @returns {Promise<HieroProto.proto.ITransactionResponse>}
+   */
+  _execute(channel, request) {
+    return channel.token.airdropTokens(request);
+  }
+
+  /**
+   * @override
+   * @protected
+   * @returns {NonNullable<HieroProto.proto.TransactionBody["data"]>}
+   */
+  _getTransactionDataCase() {
+    return "tokenAirdrop";
+  }
+
+  /**
+   * @returns {string}
+   */
+  _getLogId() {
+    const timestamp = /** @type {import("../Timestamp.js").default} */
+    this._transactionIds.current.validStart;
+    return `TokenAirdropTransaction:${timestamp.toString()}`;
+  }
+}
+exports.default = TokenAirdropTransaction;
+_Transaction.TRANSACTION_REGISTRY.set("tokenAirdrop",
+// eslint-disable-next-line @typescript-eslint/unbound-method
+TokenAirdropTransaction._fromProtobuf);

package/lib/token/TokenAirdropTransaction.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.ITokenAirdropTransactionBody} HieroProto.proto.ITokenAirdropTransactionBody
+ * @typedef {import("@hashgraph/proto").proto.ITransaction} HieroProto.proto.ITransaction
+ * @typedef {import("@hashgraph/proto").proto.TransactionID} HieroProto.proto.TransactionID
+ * @typedef {import("@hashgraph/proto").proto.AccountID} HieroProto.proto.AccountID
+ * @typedef {import("@hashgraph/proto").proto.ISignedTransaction} HieroProto.proto.ISignedTransaction
+ * @typedef {import("@hashgraph/proto").proto.ITransactionBody} HieroProto.proto.ITransactionBody
+ * @typedef {import("@hashgraph/proto").proto.TransactionBody} HieroProto.proto.TransactionBody
+ * @typedef {import("@hashgraph/proto").proto.ITransactionResponse} HieroProto.proto.ITransactionResponse
+ */
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../transaction/TransactionId.js").default} TransactionId
+ * @typedef {import("../account/AccountId.js").default} AccountId
+ * @typedef {import("./NftId.js").default} NftId
+ * @typedef {import("./TokenId.js").default} TokenId
+ */
+/**
+ * Airdrop one or more tokens to one or more accounts.
+ *
+ * ### Effects
+ * This distributes tokens from the balance of one or more sending account(s)
+ * to the balance of one or more recipient accounts. Accounts MAY receive the
+ * tokens in one of four ways.
+ *
+ *  - An account already associated to the token to be distributed SHALL
+ *    receive the airdropped tokens immediately to the recipient account
+ *    balance.<br/>
+ *    The fee for this transfer SHALL include the transfer, the airdrop fee,
+ *    and any custom fees.
+ *  - An account with available automatic association slots SHALL be
+ *    automatically associated to the token, and SHALL immediately receive
+ *    the airdropped tokens to the recipient account balance.<br/>
+ *    The fee for this transfer SHALL include the transfer, the association,
+ *    the cost to renew that association once, the airdrop fee, and
+ *    any custom fees.
+ *  - An account with "receiver signature required" set SHALL have a
+ *    "Pending Airdrop" created and must claim that airdrop with a
+ *    `claimAirdrop` transaction.<br/>
+ *    The fee for this transfer SHALL include the transfer, the association,
+ *    the cost to renew that association once, the airdrop fee, and
+ *    any custom fees.<br/>
+ *    If the pending airdrop is not claimed immediately, the `sender` SHALL
+ *    pay the cost to renew the token association, and the cost to maintain
+ *    the pending airdrop, until the pending airdrop is claimed or cancelled.
+ *  - An account with no available automatic association slots SHALL have a
+ *    "Pending Airdrop" created and must claim that airdrop with a
+ *    `claimAirdrop` transaction.<br/>
+ *    The fee for this transfer SHALL include the transfer, the association,
+ *    the cost to renew that association once, the airdrop fee, and any custom
+ *    fees.<br/>
+ *    If the pending airdrop is not claimed immediately, the `sender` SHALL
+ *    pay the cost to renew the token association, and the cost to maintain
+ *    the pending airdrop, until the pending airdrop is claimed or cancelled.
+ *
+ * If an airdrop would create a pending airdrop for a fungible/common token,
+ * and a pending airdrop for the same sender, receiver, and token already
+ * exists, the existing pending airdrop SHALL be updated to add the new
+ * amount to the existing airdrop, rather than creating
+ * a new pending airdrop.<br/>
+ * Any airdrop that completes immediately SHALL be irreversible. Any airdrop
+ * that results in a "Pending Airdrop" MAY be canceled via a `cancelAirdrop`
+ * transaction.<br/>
+ * All transfer fees (including custom fees and royalties), as well as the
+ * rent cost for the first auto-renewal period for any automatic-association
+ * slot occupied by the airdropped tokens, SHALL be charged to the account
+ * paying for this transaction.<br/>
+ */
+export default class TokenAirdropTransaction extends AbstractTokenTransferTransaction {
+    /**
+     * @internal
+     * @param {HieroProto.proto.ITransaction[]} transactions
+     * @param {HieroProto.proto.ISignedTransaction[]} signedTransactions
+     * @param {TransactionId[]} transactionIds
+     * @param {AccountId[]} nodeIds
+     * @param {HieroProto.proto.ITransactionBody[]} bodies
+     * @returns {TokenAirdropTransaction}
+     */
+    static _fromProtobuf(transactions: HieroProto.proto.ITransaction[], signedTransactions: HieroProto.proto.ISignedTransaction[], transactionIds: TransactionId[], nodeIds: AccountId[], bodies: HieroProto.proto.ITransactionBody[]): TokenAirdropTransaction;
+    /**
+     * @param {object} props
+     * @param {TokenTransfer[]} [props.tokenTransfers]
+     * @param {NftTransfer[]} [props.nftTransfers]
+     */
+    constructor(props?: {
+        tokenTransfers?: TokenTransfer[] | undefined;
+        nftTransfers?: NftTransfer[] | undefined;
+    });
+    /**
+     *
+     * @param {TokenId} tokenId
+     * @param {AccountId} accountId
+     * @param {Long} amount
+     * @param {number} expectedDecimals
+     * @returns {this}
+     */
+    addApprovedTokenTransferWithDecimals(tokenId: TokenId, accountId: AccountId, amount: Long, expectedDecimals: number): this;
+}
+export namespace HieroProto {
+    namespace proto {
+        type ITokenAirdropTransactionBody = import("@hashgraph/proto").proto.ITokenAirdropTransactionBody;
+        type ITransaction = import("@hashgraph/proto").proto.ITransaction;
+        type TransactionID = import("@hashgraph/proto").proto.TransactionID;
+        type AccountID = import("@hashgraph/proto").proto.AccountID;
+        type ISignedTransaction = import("@hashgraph/proto").proto.ISignedTransaction;
+        type ITransactionBody = import("@hashgraph/proto").proto.ITransactionBody;
+        type TransactionBody = import("@hashgraph/proto").proto.TransactionBody;
+        type ITransactionResponse = import("@hashgraph/proto").proto.ITransactionResponse;
+    }
+}
+export type Channel = import("../channel/Channel.js").default;
+export type TransactionId = import("../transaction/TransactionId.js").default;
+export type AccountId = import("../account/AccountId.js").default;
+export type NftId = import("./NftId.js").default;
+export type TokenId = import("./TokenId.js").default;
+import AbstractTokenTransferTransaction from "./AbstractTokenTransferTransaction.js";
+import TokenTransfer from "./TokenTransfer.js";
+import NftTransfer from "./TokenNftTransfer.js";

package/lib/token/TokenAirdropTransaction.js

@@ -0,0 +1,2 @@
+import r,{TRANSACTION_REGISTRY as t}from"../transaction/Transaction.js";import o from"./TokenTransfer.js";import n from"./TokenNftTransfer.js";import e from"./AbstractTokenTransferTransaction.js";class s extends e{constructor(r={}){if(super(),null!=r.tokenTransfers)for(const t of r.tokenTransfers)this._addTokenTransfer(t.tokenId,t.accountId,t.amount,t.isApproved,t.expectedDecimals);if(this._nftTransfers=[],null!=r.nftTransfers)for(const t of r.nftTransfers)this._addNftTransfer(t.isApproved,t.tokenId,t.serialNumber,t.senderAccountId,t.receiverAccountId)}addApprovedTokenTransferWithDecimals(r,t,o,n){return this._requireNotFrozen(),this._addTokenTransfer(r,t,o,!0,n),this}static _fromProtobuf(t,e,a,f,i){const T=i[0].tokenAirdrop,d=o._fromProtobuf(T.tokenTransfers??[]),c=n._fromProtobuf(T.tokenTransfers??[]);return r._fromProtobufTransactions(new s({nftTransfers:c,tokenTransfers:d}),t,e,a,f,i)}_execute(r,t){return r.token.airdropTokens(t)}_getTransactionDataCase(){return"tokenAirdrop"}_getLogId(){return`TokenAirdropTransaction:${this._transactionIds.current.validStart.toString()}`}}t.set("tokenAirdrop",s._fromProtobuf);export{s as default};
+//# sourceMappingURL=TokenAirdropTransaction.js.map

package/lib/token/TokenAirdropTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenAirdropTransaction.js","sources":["../../src/token/TokenAirdropTransaction.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\nimport Transaction, {\n    TRANSACTION_REGISTRY,\n} from \"../transaction/Transaction.js\";\nimport TokenTransfer from \"./TokenTransfer.js\";\nimport NftTransfer from \"./TokenNftTransfer.js\";\nimport AbstractTokenTransferTransaction from \"./AbstractTokenTransferTransaction.js\";\n\n/**\n * @namespace proto\n * @typedef {import(\"@hashgraph/proto\").proto.ITokenAirdropTransactionBody} HieroProto.proto.ITokenAirdropTransactionBody\n * @typedef {import(\"@hashgraph/proto\").proto.ITransaction} HieroProto.proto.ITransaction\n * @typedef {import(\"@hashgraph/proto\").proto.TransactionID} HieroProto.proto.TransactionID\n * @typedef {import(\"@hashgraph/proto\").proto.AccountID} HieroProto.proto.AccountID\n * @typedef {import(\"@hashgraph/proto\").proto.ISignedTransaction} HieroProto.proto.ISignedTransaction\n * @typedef {import(\"@hashgraph/proto\").proto.ITransactionBody} HieroProto.proto.ITransactionBody\n * @typedef {import(\"@hashgraph/proto\").proto.TransactionBody} HieroProto.proto.TransactionBody\n * @typedef {import(\"@hashgraph/proto\").proto.ITransactionResponse} HieroProto.proto.ITransactionResponse\n */\n\n/**\n * @typedef {import(\"../channel/Channel.js\").default} Channel\n * @typedef {import(\"../transaction/TransactionId.js\").default} TransactionId\n * @typedef {import(\"../account/AccountId.js\").default} AccountId\n * @typedef {import(\"./NftId.js\").default} NftId\n * @typedef {import(\"./TokenId.js\").default} TokenId\n */\n\n/**\n * Airdrop one or more tokens to one or more accounts.\n *\n * ### Effects\n * This distributes tokens from the balance of one or more sending account(s)\n * to the balance of one or more recipient accounts. Accounts MAY receive the\n * tokens in one of four ways.\n *\n *  - An account already associated to the token to be distributed SHALL\n *    receive the airdropped tokens immediately to the recipient account\n *    balance.<br/>\n *    The fee for this transfer SHALL include the transfer, the airdrop fee,\n *    and any custom fees.\n *  - An account with available automatic association slots SHALL be\n *    automatically associated to the token, and SHALL immediately receive\n *    the airdropped tokens to the recipient account balance.<br/>\n *    The fee for this transfer SHALL include the transfer, the association,\n *    the cost to renew that association once, the airdrop fee, and\n *    any custom fees.\n *  - An account with \"receiver signature required\" set SHALL have a\n *    \"Pending Airdrop\" created and must claim that airdrop with a\n *    `claimAirdrop` transaction.<br/>\n *    The fee for this transfer SHALL include the transfer, the association,\n *    the cost to renew that association once, the airdrop fee, and\n *    any custom fees.<br/>\n *    If the pending airdrop is not claimed immediately, the `sender` SHALL\n *    pay the cost to renew the token association, and the cost to maintain\n *    the pending airdrop, until the pending airdrop is claimed or cancelled.\n *  - An account with no available automatic association slots SHALL have a\n *    \"Pending Airdrop\" created and must claim that airdrop with a\n *    `claimAirdrop` transaction.<br/>\n *    The fee for this transfer SHALL include the transfer, the association,\n *    the cost to renew that association once, the airdrop fee, and any custom\n *    fees.<br/>\n *    If the pending airdrop is not claimed immediately, the `sender` SHALL\n *    pay the cost to renew the token association, and the cost to maintain\n *    the pending airdrop, until the pending airdrop is claimed or cancelled.\n *\n * If an airdrop would create a pending airdrop for a fungible/common token,\n * and a pending airdrop for the same sender, receiver, and token already\n * exists, the existing pending airdrop SHALL be updated to add the new\n * amount to the existing airdrop, rather than creating\n * a new pending airdrop.<br/>\n * Any airdrop that completes immediately SHALL be irreversible. Any airdrop\n * that results in a \"Pending Airdrop\" MAY be canceled via a `cancelAirdrop`\n * transaction.<br/>\n * All transfer fees (including custom fees and royalties), as well as the\n * rent cost for the first auto-renewal period for any automatic-association\n * slot occupied by the airdropped tokens, SHALL be charged to the account\n * paying for this transaction.<br/>\n */\nexport default class TokenAirdropTransaction extends AbstractTokenTransferTransaction {\n    /**\n     * @param {object} props\n     * @param {TokenTransfer[]} [props.tokenTransfers]\n     * @param {NftTransfer[]} [props.nftTransfers]\n     */\n    constructor(props = {}) {\n        super();\n\n        if (props.tokenTransfers != null) {\n            for (const tokenTransfer of props.tokenTransfers) {\n                this._addTokenTransfer(\n                    tokenTransfer.tokenId,\n                    tokenTransfer.accountId,\n                    tokenTransfer.amount,\n                    tokenTransfer.isApproved,\n                    tokenTransfer.expectedDecimals,\n                );\n            }\n        }\n        /**\n         * @private\n         * @type {NftTransfer[]}\n         */\n        this._nftTransfers = [];\n        if (props.nftTransfers != null) {\n            for (const nftTransfer of props.nftTransfers) {\n                this._addNftTransfer(\n                    nftTransfer.isApproved,\n                    nftTransfer.tokenId,\n                    nftTransfer.serialNumber,\n                    nftTransfer.senderAccountId,\n                    nftTransfer.receiverAccountId,\n                );\n            }\n        }\n    }\n\n    /**\n     *\n     * @param {TokenId} tokenId\n     * @param {AccountId} accountId\n     * @param {Long} amount\n     * @param {number} expectedDecimals\n     * @returns {this}\n     */\n    addApprovedTokenTransferWithDecimals(\n        tokenId,\n        accountId,\n        amount,\n        expectedDecimals,\n    ) {\n        this._requireNotFrozen();\n        this._addTokenTransfer(\n            tokenId,\n            accountId,\n            amount,\n            true,\n            expectedDecimals,\n        );\n        return this;\n    }\n\n    /**\n     * @internal\n     * @param {HieroProto.proto.ITransaction[]} transactions\n     * @param {HieroProto.proto.ISignedTransaction[]} signedTransactions\n     * @param {TransactionId[]} transactionIds\n     * @param {AccountId[]} nodeIds\n     * @param {HieroProto.proto.ITransactionBody[]} bodies\n     * @returns {TokenAirdropTransaction}\n     */\n    static _fromProtobuf(\n        transactions,\n        signedTransactions,\n        transactionIds,\n        nodeIds,\n        bodies,\n    ) {\n        const body = bodies[0];\n        const tokenAirdrop =\n            /** @type {HieroProto.proto.ITokenAirdropTransactionBody} */ (\n                body.tokenAirdrop\n            );\n\n        const tokenTransfers = TokenTransfer._fromProtobuf(\n            tokenAirdrop.tokenTransfers ?? [],\n        );\n        const nftTransfers = NftTransfer._fromProtobuf(\n            tokenAirdrop.tokenTransfers ?? [],\n        );\n\n        return Transaction._fromProtobufTransactions(\n            new TokenAirdropTransaction({\n                nftTransfers: nftTransfers,\n                tokenTransfers: tokenTransfers,\n            }),\n            transactions,\n            signedTransactions,\n            transactionIds,\n            nodeIds,\n            bodies,\n        );\n    }\n\n    /**\n     * @override\n     * @internal\n     * @param {Channel} channel\n     * @param {HieroProto.proto.ITransaction} request\n     * @returns {Promise<HieroProto.proto.ITransactionResponse>}\n     */\n    _execute(channel, request) {\n        return channel.token.airdropTokens(request);\n    }\n\n    /**\n     * @override\n     * @protected\n     * @returns {NonNullable<HieroProto.proto.TransactionBody[\"data\"]>}\n     */\n    _getTransactionDataCase() {\n        return \"tokenAirdrop\";\n    }\n\n    /**\n     * @returns {string}\n     */\n    _getLogId() {\n        const timestamp = /** @type {import(\"../Timestamp.js\").default} */ (\n            this._transactionIds.current.validStart\n        );\n        return `TokenAirdropTransaction:${timestamp.toString()}`;\n    }\n}\n\nTRANSACTION_REGISTRY.set(\n    \"tokenAirdrop\",\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    TokenAirdropTransaction._fromProtobuf,\n);\n"],"names":["TokenAirdropTransaction","AbstractTokenTransferTransaction","constructor","props","super","tokenTransfers","tokenTransfer","this","_addTokenTransfer","tokenId","accountId","amount","isApproved","expectedDecimals","_nftTransfers","nftTransfers","nftTransfer","_addNftTransfer","serialNumber","senderAccountId","receiverAccountId","addApprovedTokenTransferWithDecimals","_requireNotFrozen","_fromProtobuf","transactions","signedTransactions","transactionIds","nodeIds","bodies","tokenAirdrop","TokenTransfer","NftTransfer","Transaction","_fromProtobufTransactions","_execute","channel","request","token","airdropTokens","_getTransactionDataCase","_getLogId","_transactionIds","current","toString","TRANSACTION_REGISTRY","set"],"mappings":"oMA+Ee,MAAMA,UAAgCC,EAMjD,WAAAC,CAAYC,EAAQ,IAGhB,GAFAC,QAE4B,MAAxBD,EAAME,eACN,IAAK,MAAMC,KAAiBH,EAAME,eAC9BE,KAAKC,kBACDF,EAAcG,QACdH,EAAcI,UACdJ,EAAcK,OACdL,EAAcM,WACdN,EAAcO,kBAS1B,GADAN,KAAKO,cAAgB,GACK,MAAtBX,EAAMY,aACN,IAAK,MAAMC,KAAeb,EAAMY,aAC5BR,KAAKU,gBACDD,EAAYJ,WACZI,EAAYP,QACZO,EAAYE,aACZF,EAAYG,gBACZH,EAAYI,kBAIhC,CAUI,oCAAAC,CACIZ,EACAC,EACAC,EACAE,GAUA,OARAN,KAAKe,oBACLf,KAAKC,kBACDC,EACAC,EACAC,GACA,EACAE,GAEGN,IACf,CAWI,oBAAOgB,CACHC,EACAC,EACAC,EACAC,EACAC,GAEA,MACMC,EADOD,EAAO,GAIf,aAECvB,EAAiByB,EAAcP,cACjCM,EAAaxB,gBAAkB,IAE7BU,EAAegB,EAAYR,cAC7BM,EAAaxB,gBAAkB,IAGnC,OAAO2B,EAAYC,0BACf,IAAIjC,EAAwB,CACxBe,aAAcA,EACdV,eAAgBA,IAEpBmB,EACAC,EACAC,EACAC,EACAC,EAEZ,CASI,QAAAM,CAASC,EAASC,GACd,OAAOD,EAAQE,MAAMC,cAAcF,EAC3C,CAOI,uBAAAG,GACI,MAAO,cACf,CAKI,SAAAC,GAII,MAAO,2BAFHjC,KAAKkC,gBAAgBC,QACxB,WAC2CC,YACpD,EAGAC,EAAqBC,IACjB,eAEA7C,EAAwBuB"}