xrpl 2.7.0-beta.0 → 2.7.0-beta.1

package/dist/npm/snippets/src/sendEscrow.js

@@ -0,0 +1,56 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const src_1 = require("../../src");
+const client = new src_1.Client('wss://s.altnet.rippletest.net:51233');
+void sendEscrow();
+function sendEscrow() {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield client.connect();
+        const { wallet: wallet1 } = yield client.fundWallet();
+        const { wallet: wallet2 } = yield client.fundWallet();
+        console.log('Balances of wallets before Escrow tx was created:');
+        console.log(yield client.getXrpBalance(wallet1.classicAddress), yield client.getXrpBalance(wallet2.classicAddress));
+        const finishAfter = (0, src_1.isoTimeToRippleTime)(Date()) + 2;
+        const createTx = {
+            TransactionType: 'EscrowCreate',
+            Account: wallet1.address,
+            Destination: wallet2.address,
+            Amount: '1000000',
+            FinishAfter: finishAfter,
+        };
+        const createEscrowResponse = yield client.submitAndWait(createTx, {
+            wallet: wallet1,
+        });
+        console.log(createEscrowResponse);
+        const accountObjectsRequest = {
+            command: 'account_objects',
+            account: wallet1.classicAddress,
+        };
+        const accountObjects = (yield client.request(accountObjectsRequest)).result
+            .account_objects;
+        console.log("Escrow object exists in `wallet1`'s account");
+        console.log(accountObjects);
+        const finishTx = {
+            TransactionType: 'EscrowFinish',
+            Account: wallet1.classicAddress,
+            Owner: wallet1.classicAddress,
+            OfferSequence: Number(createEscrowResponse.result.Sequence),
+        };
+        yield client.submit(finishTx, {
+            wallet: wallet1,
+        });
+        console.log('Balances of wallets after Escrow was sent');
+        console.log(yield client.getXrpBalance(wallet1.classicAddress), yield client.getXrpBalance(wallet2.classicAddress));
+        yield client.disconnect();
+    });
+}
+//# sourceMappingURL=sendEscrow.js.map

package/dist/npm/snippets/src/sendEscrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendEscrow.js","sourceRoot":"","sources":["../../../../snippets/src/sendEscrow.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,mCAMkB;AAElB,MAAM,MAAM,GAAG,IAAI,YAAM,CAAC,qCAAqC,CAAC,CAAA;AAEhE,KAAK,UAAU,EAAE,CAAA;AAGjB,SAAe,UAAU;;QACvB,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QAGtB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;QACrD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;QAErD,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAA;QAChE,OAAO,CAAC,GAAG,CACT,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,EAClD,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CACnD,CAAA;QAGD,MAAM,WAAW,GAAG,IAAA,yBAAmB,EAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;QAGnD,MAAM,QAAQ,GAAiB;YAC7B,eAAe,EAAE,cAAc;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,WAAW;SACzB,CAAA;QAED,MAAM,oBAAoB,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE;YAChE,MAAM,EAAE,OAAO;SAChB,CAAC,CAAA;QAEF,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;QAGjC,MAAM,qBAAqB,GAA0B;YACnD,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,OAAO,CAAC,cAAc;SAChC,CAAA;QAED,MAAM,cAAc,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,MAAM;aACxE,eAAe,CAAA;QAElB,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAA;QAC1D,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QAG3B,MAAM,QAAQ,GAAiB;YAC7B,eAAe,EAAE,cAAc;YAC/B,OAAO,EAAE,OAAO,CAAC,cAAc;YAC/B,KAAK,EAAE,OAAO,CAAC,cAAc;YAC7B,aAAa,EAAE,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC5D,CAAA;QAED,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC5B,MAAM,EAAE,OAAO;SAChB,CAAC,CAAA;QAGF,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAA;QACxD,OAAO,CAAC,GAAG,CACT,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,EAClD,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CACnD,CAAA;QAED,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;IAC3B,CAAC;CAAA"}

package/dist/npm/snippets/src/setRegularKey.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setRegularKey.d.ts.map

package/dist/npm/snippets/src/setRegularKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setRegularKey.d.ts","sourceRoot":"","sources":["../../../../snippets/src/setRegularKey.ts"],"names":[],"mappings":""}

package/dist/npm/snippets/src/setRegularKey.js

@@ -0,0 +1,51 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const src_1 = require("../../src");
+const client = new src_1.Client('wss://s.altnet.rippletest.net:51233');
+function setRegularKey() {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield client.connect();
+        const { wallet: wallet1 } = yield client.fundWallet();
+        const { wallet: wallet2 } = yield client.fundWallet();
+        const { wallet: regularKeyWallet } = yield client.fundWallet();
+        console.log('Balances before payment');
+        console.log(yield client.getXrpBalance(wallet1.classicAddress));
+        console.log(yield client.getXrpBalance(wallet2.classicAddress));
+        const tx = {
+            TransactionType: 'SetRegularKey',
+            Account: wallet1.classicAddress,
+            RegularKey: regularKeyWallet.classicAddress,
+        };
+        const response = yield client.submitAndWait(tx, {
+            wallet: wallet1,
+        });
+        console.log('Response for successful SetRegularKey tx');
+        console.log(response);
+        const payment = {
+            TransactionType: 'Payment',
+            Account: wallet1.classicAddress,
+            Destination: wallet2.classicAddress,
+            Amount: '1000',
+        };
+        const submitTx = yield client.submit(payment, {
+            wallet: regularKeyWallet,
+        });
+        console.log('Response for tx signed using Regular Key:');
+        console.log(submitTx);
+        console.log('Balances after payment:');
+        console.log(yield client.getXrpBalance(wallet1.classicAddress));
+        console.log(yield client.getXrpBalance(wallet2.classicAddress));
+        yield client.disconnect();
+    });
+}
+void setRegularKey();
+//# sourceMappingURL=setRegularKey.js.map

package/dist/npm/snippets/src/setRegularKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setRegularKey.js","sourceRoot":"","sources":["../../../../snippets/src/setRegularKey.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,mCAA0D;AAE1D,MAAM,MAAM,GAAG,IAAI,YAAM,CAAC,qCAAqC,CAAC,CAAA;AAMhE,SAAe,aAAa;;QAC1B,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;QACtB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;QACrD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;QACrD,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;QAE9D,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;QAC/D,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;QAG/D,MAAM,EAAE,GAAkB;YACxB,eAAe,EAAE,eAAe;YAChC,OAAO,EAAE,OAAO,CAAC,cAAc;YAC/B,UAAU,EAAE,gBAAgB,CAAC,cAAc;SAC5C,CAAA;QACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE;YAC9C,MAAM,EAAE,OAAO;SAChB,CAAC,CAAA;QAEF,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAA;QACvD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAMrB,MAAM,OAAO,GAAY;YACvB,eAAe,EAAE,SAAS;YAC1B,OAAO,EAAE,OAAO,CAAC,cAAc;YAC/B,WAAW,EAAE,OAAO,CAAC,cAAc;YACnC,MAAM,EAAE,MAAM;SACf,CAAA;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;YAC5C,MAAM,EAAE,gBAAgB;SACzB,CAAC,CAAA;QACF,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAA;QACxD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACrB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;QAC/D,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;QAE/D,MAAM,MAAM,CAAC,UAAU,EAAE,CAAA;IAC3B,CAAC;CAAA;AACD,KAAK,aAAa,EAAE,CAAA"}

package/dist/npm/src/ECDSA.d.ts

@@ -0,0 +1,6 @@
+declare enum ECDSA {
+    ed25519 = "ed25519",
+    secp256k1 = "ecdsa-secp256k1"
+}
+export default ECDSA;
+//# sourceMappingURL=ECDSA.d.ts.map

package/dist/npm/src/ECDSA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECDSA.d.ts","sourceRoot":"","sources":["../../../src/ECDSA.ts"],"names":[],"mappings":"AAAA,aAAK,KAAK;IACR,OAAO,YAAY;IACnB,SAAS,oBAAoB;CAC9B;AAED,eAAe,KAAK,CAAA"}

package/dist/npm/src/ECDSA.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var ECDSA;
+(function (ECDSA) {
+    ECDSA["ed25519"] = "ed25519";
+    ECDSA["secp256k1"] = "ecdsa-secp256k1";
+})(ECDSA || (ECDSA = {}));
+exports.default = ECDSA;
+//# sourceMappingURL=ECDSA.js.map

package/dist/npm/src/ECDSA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECDSA.js","sourceRoot":"","sources":["../../../src/ECDSA.ts"],"names":[],"mappings":";;AAAA,IAAK,KAGJ;AAHD,WAAK,KAAK;IACR,4BAAmB,CAAA;IACnB,sCAA6B,CAAA;AAC/B,CAAC,EAHI,KAAK,KAAL,KAAK,QAGT;AAED,kBAAe,KAAK,CAAA"}

package/dist/npm/src/Wallet/defaultFaucets.d.ts

@@ -0,0 +1,21 @@
+import type { Client } from '../client';
+export interface FaucetWallet {
+    account: {
+        xAddress: string;
+        classicAddress?: string;
+        secret: string;
+    };
+    amount: number;
+    balance: number;
+}
+export declare enum FaucetNetwork {
+    Testnet = "faucet.altnet.rippletest.net",
+    Devnet = "faucet.devnet.rippletest.net",
+    AMMDevnet = "ammfaucet.devnet.rippletest.net",
+    NFTDevnet = "faucet-nft.ripple.com",
+    HooksV2Testnet = "hooks-testnet-v2.xrpl-labs.com"
+}
+export declare const FaucetNetworkPaths: Record<string, string>;
+export declare function getFaucetHost(client: Client): FaucetNetwork | undefined;
+export declare function getDefaultFaucetPath(hostname: string | undefined): string;
+//# sourceMappingURL=defaultFaucets.d.ts.map

package/dist/npm/src/Wallet/defaultFaucets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultFaucets.d.ts","sourceRoot":"","sources":["../../../../src/Wallet/defaultFaucets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAGvC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAA;QAChB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,oBAAY,aAAa;IACvB,OAAO,iCAAiC;IACxC,MAAM,iCAAiC;IACvC,SAAS,oCAAoC;IAC7C,SAAS,0BAA0B;IACnC,cAAc,mCAAmC;CAClD;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMrD,CAAA;AASD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CA0BvE;AASD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKzE"}

package/dist/npm/src/Wallet/defaultFaucets.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultFaucetPath = exports.getFaucetHost = exports.FaucetNetworkPaths = exports.FaucetNetwork = void 0;
+const errors_1 = require("../errors");
+var FaucetNetwork;
+(function (FaucetNetwork) {
+    FaucetNetwork["Testnet"] = "faucet.altnet.rippletest.net";
+    FaucetNetwork["Devnet"] = "faucet.devnet.rippletest.net";
+    FaucetNetwork["AMMDevnet"] = "ammfaucet.devnet.rippletest.net";
+    FaucetNetwork["NFTDevnet"] = "faucet-nft.ripple.com";
+    FaucetNetwork["HooksV2Testnet"] = "hooks-testnet-v2.xrpl-labs.com";
+})(FaucetNetwork = exports.FaucetNetwork || (exports.FaucetNetwork = {}));
+exports.FaucetNetworkPaths = {
+    [FaucetNetwork.Testnet]: '/accounts',
+    [FaucetNetwork.Devnet]: '/accounts',
+    [FaucetNetwork.AMMDevnet]: '/accounts',
+    [FaucetNetwork.NFTDevnet]: '/accounts',
+    [FaucetNetwork.HooksV2Testnet]: '/accounts',
+};
+function getFaucetHost(client) {
+    const connectionUrl = client.url;
+    if (connectionUrl.includes('hooks-testnet-v2')) {
+        return FaucetNetwork.HooksV2Testnet;
+    }
+    if (connectionUrl.includes('altnet') || connectionUrl.includes('testnet')) {
+        return FaucetNetwork.Testnet;
+    }
+    if (connectionUrl.includes('amm')) {
+        return FaucetNetwork.AMMDevnet;
+    }
+    if (connectionUrl.includes('devnet')) {
+        return FaucetNetwork.Devnet;
+    }
+    if (connectionUrl.includes('xls20-sandbox')) {
+        return FaucetNetwork.NFTDevnet;
+    }
+    throw new errors_1.XRPLFaucetError('Faucet URL is not defined or inferrable.');
+}
+exports.getFaucetHost = getFaucetHost;
+function getDefaultFaucetPath(hostname) {
+    if (hostname === undefined) {
+        return '/accounts';
+    }
+    return exports.FaucetNetworkPaths[hostname] || '/accounts';
+}
+exports.getDefaultFaucetPath = getDefaultFaucetPath;
+//# sourceMappingURL=defaultFaucets.js.map

package/dist/npm/src/Wallet/defaultFaucets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultFaucets.js","sourceRoot":"","sources":["../../../../src/Wallet/defaultFaucets.ts"],"names":[],"mappings":";;;AACA,sCAA2C;AAY3C,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,yDAAwC,CAAA;IACxC,wDAAuC,CAAA;IACvC,8DAA6C,CAAA;IAC7C,oDAAmC,CAAA;IACnC,kEAAiD,CAAA;AACnD,CAAC,EANW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAMxB;AAEY,QAAA,kBAAkB,GAA2B;IACxD,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW;IACpC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW;IACnC,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,WAAW;IACtC,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,WAAW;IACtC,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,WAAW;CAC5C,CAAA;AASD,SAAgB,aAAa,CAAC,MAAc;IAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA;IAEhC,IAAI,aAAa,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE;QAC9C,OAAO,aAAa,CAAC,cAAc,CAAA;KACpC;IAGD,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACzE,OAAO,aAAa,CAAC,OAAO,CAAA;KAC7B;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;QACjC,OAAO,aAAa,CAAC,SAAS,CAAA;KAC/B;IAED,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;QACpC,OAAO,aAAa,CAAC,MAAM,CAAA;KAC5B;IAGD,IAAI,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;QAC3C,OAAO,aAAa,CAAC,SAAS,CAAA;KAC/B;IAED,MAAM,IAAI,wBAAe,CAAC,0CAA0C,CAAC,CAAA;AACvE,CAAC;AA1BD,sCA0BC;AASD,SAAgB,oBAAoB,CAAC,QAA4B;IAC/D,IAAI,QAAQ,KAAK,SAAS,EAAE;QAC1B,OAAO,WAAW,CAAA;KACnB;IACD,OAAO,0BAAkB,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAA;AACpD,CAAC;AALD,oDAKC"}

package/dist/npm/src/Wallet/fundWallet.d.ts

@@ -0,0 +1,12 @@
+import type { Client } from '../client';
+import Wallet from '.';
+declare function fundWallet(this: Client, wallet?: Wallet | null, options?: {
+    faucetHost?: string;
+    faucetPath?: string;
+    amount?: string;
+}): Promise<{
+    wallet: Wallet;
+    balance: number;
+}>;
+export default fundWallet;
+//# sourceMappingURL=fundWallet.d.ts.map

package/dist/npm/src/Wallet/fundWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fundWallet.d.ts","sourceRoot":"","sources":["../../../../src/Wallet/fundWallet.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AASvC,OAAO,MAAM,MAAM,GAAG,CAAA;AAsCtB,iBAAe,UAAU,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GACA,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAC,CA0CD;AAuMD,eAAe,UAAU,CAAA"}

package/dist/npm/src/Wallet/fundWallet.js

@@ -0,0 +1,160 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const https_1 = require("https");
+const ripple_address_codec_1 = require("ripple-address-codec");
+const errors_1 = require("../errors");
+const defaultFaucets_1 = require("./defaultFaucets");
+const _1 = __importDefault(require("."));
+const INTERVAL_SECONDS = 1;
+const MAX_ATTEMPTS = 20;
+function fundWallet(wallet, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!this.isConnected()) {
+            throw new errors_1.RippledError('Client not connected, cannot call faucet');
+        }
+        const walletToFund = wallet && (0, ripple_address_codec_1.isValidClassicAddress)(wallet.classicAddress)
+            ? wallet
+            : _1.default.generate();
+        const postBody = Buffer.from(new TextEncoder().encode(JSON.stringify({
+            destination: walletToFund.classicAddress,
+            xrpAmount: options === null || options === void 0 ? void 0 : options.amount,
+        })));
+        let startingBalance = 0;
+        try {
+            startingBalance = Number(yield this.getXrpBalance(walletToFund.classicAddress));
+        }
+        catch (_a) {
+        }
+        const httpOptions = getHTTPOptions(this, postBody, {
+            hostname: options === null || options === void 0 ? void 0 : options.faucetHost,
+            pathname: options === null || options === void 0 ? void 0 : options.faucetPath,
+        });
+        return returnPromise(httpOptions, this, startingBalance, walletToFund, postBody);
+    });
+}
+function returnPromise(options, client, startingBalance, walletToFund, postBody) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            const request = (0, https_1.request)(options, (response) => {
+                const chunks = [];
+                response.on('data', (data) => chunks.push(data));
+                response.on('end', () => __awaiter(this, void 0, void 0, function* () {
+                    return onEnd(response, chunks, client, startingBalance, walletToFund, resolve, reject);
+                }));
+            });
+            request.write(postBody);
+            request.on('error', (error) => {
+                reject(error);
+            });
+            request.end();
+        });
+    });
+}
+function getHTTPOptions(client, postBody, options) {
+    var _a, _b;
+    const finalHostname = (_a = options === null || options === void 0 ? void 0 : options.hostname) !== null && _a !== void 0 ? _a : (0, defaultFaucets_1.getFaucetHost)(client);
+    const finalPathname = (_b = options === null || options === void 0 ? void 0 : options.pathname) !== null && _b !== void 0 ? _b : (0, defaultFaucets_1.getDefaultFaucetPath)(finalHostname);
+    return {
+        hostname: finalHostname,
+        port: 443,
+        path: finalPathname,
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Content-Length': postBody.length,
+        },
+    };
+}
+function onEnd(response, chunks, client, startingBalance, walletToFund, resolve, reject) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        const body = Buffer.concat(chunks).toString();
+        if ((_a = response.headers['content-type']) === null || _a === void 0 ? void 0 : _a.startsWith('application/json')) {
+            const faucetWallet = JSON.parse(body);
+            const classicAddress = faucetWallet.account.classicAddress;
+            yield processSuccessfulResponse(client, classicAddress, walletToFund, startingBalance, resolve, reject);
+        }
+        else {
+            reject(new errors_1.XRPLFaucetError(`Content type is not \`application/json\`: ${JSON.stringify({
+                statusCode: response.statusCode,
+                contentType: response.headers['content-type'],
+                body,
+            })}`));
+        }
+    });
+}
+function processSuccessfulResponse(client, classicAddress, walletToFund, startingBalance, resolve, reject) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!classicAddress) {
+            reject(new errors_1.XRPLFaucetError(`The faucet account is undefined`));
+            return;
+        }
+        try {
+            const updatedBalance = yield getUpdatedBalance(client, classicAddress, startingBalance);
+            if (updatedBalance > startingBalance) {
+                resolve({
+                    wallet: walletToFund,
+                    balance: yield getUpdatedBalance(client, walletToFund.classicAddress, startingBalance),
+                });
+            }
+            else {
+                reject(new errors_1.XRPLFaucetError(`Unable to fund address with faucet after waiting ${INTERVAL_SECONDS * MAX_ATTEMPTS} seconds`));
+            }
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                reject(new errors_1.XRPLFaucetError(err.message));
+            }
+            reject(err);
+        }
+    });
+}
+function getUpdatedBalance(client, address, originalBalance) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            let attempts = MAX_ATTEMPTS;
+            const interval = setInterval(() => __awaiter(this, void 0, void 0, function* () {
+                if (attempts < 0) {
+                    clearInterval(interval);
+                    resolve(originalBalance);
+                }
+                else {
+                    attempts -= 1;
+                }
+                try {
+                    let newBalance;
+                    try {
+                        newBalance = Number(yield client.getXrpBalance(address));
+                    }
+                    catch (_a) {
+                    }
+                    if (newBalance > originalBalance) {
+                        clearInterval(interval);
+                        resolve(newBalance);
+                    }
+                }
+                catch (err) {
+                    clearInterval(interval);
+                    if (err instanceof Error) {
+                        reject(new errors_1.XRPLFaucetError(`Unable to check if the address ${address} balance has increased. Error: ${err.message}`));
+                    }
+                    reject(err);
+                }
+            }), INTERVAL_SECONDS * 1000);
+        });
+    });
+}
+exports.default = fundWallet;
+//# sourceMappingURL=fundWallet.js.map

package/dist/npm/src/Wallet/fundWallet.js.map

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

package/dist/npm/src/Wallet/index.d.ts

@@ -0,0 +1,40 @@
+import ECDSA from '../ECDSA';
+import { Transaction } from '../models/transactions';
+declare class Wallet {
+    readonly publicKey: string;
+    readonly privateKey: string;
+    readonly classicAddress: string;
+    readonly seed?: string;
+    constructor(publicKey: string, privateKey: string, opts?: {
+        masterAddress?: string;
+        seed?: string;
+    });
+    get address(): string;
+    static generate(algorithm?: ECDSA): Wallet;
+    static fromSeed(seed: string, opts?: {
+        masterAddress?: string;
+        algorithm?: ECDSA;
+    }): Wallet;
+    static fromSecret: typeof Wallet.fromSeed;
+    static fromEntropy(entropy: Uint8Array | number[], opts?: {
+        masterAddress?: string;
+        algorithm?: ECDSA;
+    }): Wallet;
+    static fromMnemonic(mnemonic: string, opts?: {
+        masterAddress?: string;
+        derivationPath?: string;
+        mnemonicEncoding?: 'bip39' | 'rfc1751';
+        algorithm?: ECDSA;
+    }): Wallet;
+    private static fromRFC1751Mnemonic;
+    private static deriveWallet;
+    sign(this: Wallet, transaction: Transaction, multisign?: boolean | string): {
+        tx_blob: string;
+        hash: string;
+    };
+    verifyTransaction(signedTransaction: Transaction | string): boolean;
+    getXAddress(tag?: number | false, isTestnet?: boolean): string;
+    private checkTxSerialization;
+}
+export default Wallet;
+//# sourceMappingURL=index.d.ts.map

package/dist/npm/src/Wallet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Wallet/index.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,MAAM,UAAU,CAAA;AAG5B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAsDpD,cAAM,MAAM;IACV,SAAgB,SAAS,EAAE,MAAM,CAAA;IACjC,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,cAAc,EAAE,MAAM,CAAA;IACtC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAA;gBAY3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;QACJ,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,IAAI,CAAC,EAAE,MAAM,CAAA;KACT;IAeR,IAAW,OAAO,IAAI,MAAM,CAE3B;WAQa,QAAQ,CAAC,SAAS,GAAE,KAAyB,GAAG,MAAM;WActD,QAAQ,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAA;KAAO,GACvD,MAAM;IAiBT,OAAc,UAAU,yBAAkB;WAW5B,WAAW,CACvB,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,EAC9B,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAA;KAAO,GACvD,MAAM;WAiCK,YAAY,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;QACJ,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACtC,SAAS,CAAC,EAAE,KAAK,CAAA;KACb,GACL,MAAM;IAyCT,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA4BlC,OAAO,CAAC,MAAM,CAAC,YAAY;IAwBpB,IAAI,CACT,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,EACxB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAC3B;QACD,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;KACb;IAsDM,iBAAiB,CAAC,iBAAiB,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO;IAiBnE,WAAW,CAAC,GAAG,GAAE,MAAM,GAAG,KAAa,EAAE,SAAS,UAAQ,GAAG,MAAM;IAgB1E,OAAO,CAAC,oBAAoB;CA4G7B;AAgED,eAAe,MAAM,CAAA"}