@bithomp/xrpl-api 3.4.5 → 3.5.0

package/lib/connection.d.ts

@@ -32,7 +32,7 @@ declare class Connection extends EventEmitter {
     types: string[];
     latency: LatencyInfo[];
     readonly logger?: any;
-    readonly timeout?: number;
+    readonly timeout: number;
     readonly connectionTimeout: number;
     readonly hash?: string;
     private onlineSince;

package/lib/connection.js

@@ -45,7 +45,7 @@ const common_1 = require("./common");
 const utils_1 = require("./common/utils");
 const XRPLConnection = __importStar(require("xrpl/dist/npm/client/connection"));
 const RECONNECT_TIMEOUT = 1000 * 5;
-const LEDGER_CLOSED_TIMEOUT = 1000 * 15;
+const LEDGER_CLOSED_TIMEOUT = 1000 * 20;
 const SERVER_INFO_UPDATE_INTERVAL = 1000 * 60 * 5;
 const AVAILABLE_LEDGER_INDEX_WINDOW = 1000;
 exports.DEFAULT_API_VERSION = xrpl_1.RIPPLED_API_V1;
@@ -64,7 +64,7 @@ class Connection extends events_1.EventEmitter {
         this.updateTypes();
         this.client = null;
         this.logger = options.logger;
-        this.timeout = options.timeout;
+        this.timeout = options.timeout || LEDGER_CLOSED_TIMEOUT;
         this.connectionTimeout = options.connectionTimeout || RECONNECT_TIMEOUT;
         this.hash = crypto_1.default.createHash("sha256").update(url).digest("hex");
         if (typeof options.networkID === "number") {
@@ -114,7 +114,7 @@ class Connection extends events_1.EventEmitter {
     async request(request, options) {
         const result = await this._request(request, options);
         if (result?.error === "timeout") {
-            const timeouts = this.latency.filter((info) => info.delta >= this.connectionTimeout).length;
+            const timeouts = this.latency.filter((info) => info.delta >= this.timeout).length;
             if (timeouts >= 3) {
                 this.logger?.debug({
                     service: "Bithomp::XRPL::Connection",
@@ -153,7 +153,7 @@ class Connection extends events_1.EventEmitter {
             return response;
         }
         catch (err) {
-            this.updateLatency(RECONNECT_TIMEOUT);
+            this.updateLatency(err.name === "TimeoutError" ? this.timeout : this.connectionTimeout);
             this.logger?.debug({
                 service: "Bithomp::XRPL::Connection",
                 function: "request",
@@ -176,7 +176,6 @@ class Connection extends events_1.EventEmitter {
             return await this.request({ command: "submit", tx_blob: transaction });
         }
         catch (err) {
-            this.updateLatency(1000);
             this.logger?.debug({
                 service: "Bithomp::XRPL::Connection",
                 function: "submit",

package/lib/ledger/account_tx.js

@@ -333,12 +333,24 @@ function counterpartyFilter(options, transaction) {
     if (transaction.tx.Destination === options.counterparty) {
         return true;
     }
+    if (transaction.tx.Delegate === options.counterparty) {
+        return true;
+    }
+    if (transaction.tx.Subject === options.counterparty) {
+        return true;
+    }
     if (transaction.tx.Amount?.issuer === options.counterparty) {
         return true;
     }
     if (transaction.tx.SendMax?.issuer === options.counterparty) {
         return true;
     }
+    if (typeof transaction.tx.TakerGets === "object" && transaction.tx.TakerGets?.issuer === options.counterparty) {
+        return true;
+    }
+    if (typeof transaction.tx.TakerPays === "object" && transaction.tx.TakerPays?.issuer === options.counterparty) {
+        return true;
+    }
     if (transaction.tx.LimitAmount?.issuer === options.counterparty) {
         return true;
     }

package/lib/parse/ledger/credential-flags.d.ts

@@ -0,0 +1,5 @@
+import { CredentialFlagsKeysInterface } from "../../types/credentials";
+declare function parseCredentialFlags(value: number, options?: {
+    excludeFalse?: boolean;
+}): CredentialFlagsKeysInterface;
+export default parseCredentialFlags;

package/lib/parse/ledger/credential-flags.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const credentials_1 = require("../../types/credentials");
+const flags_1 = require("./flags");
+function parseCredentialFlags(value, options = {}) {
+    return (0, flags_1.parseFlags)(value, credentials_1.CredentialFlagsKeys, options);
+}
+exports.default = parseCredentialFlags;

package/lib/parse/ledger/memos.js

@@ -12,7 +12,7 @@ function parseMemos(tx) {
         return (0, common_1.removeUndefined)({
             type: (0, utils_1.hexToString)(m.Memo.MemoType),
             format: (0, utils_1.hexToString)(m.Memo.MemoFormat),
-            data: decodeData(m.Memo.MemoData),
+            data: (0, utils_1.decodeHexData)(m.Memo.MemoData),
         });
     });
 }
@@ -25,13 +25,3 @@ function formattedMemoToMemo(memo) {
         }),
     };
 }
-function decodeData(data) {
-    if (!data) {
-        return undefined;
-    }
-    const decoded = (0, utils_1.hexToString)(data);
-    if (decoded && decoded.includes("�")) {
-        return data;
-    }
-    return decoded;
-}

package/lib/parse/ledger/remarks.js

@@ -31,17 +31,7 @@ function parseRemark(remark) {
     const { RemarkName, RemarkValue, Flags } = remark.Remark;
     return (0, common_1.removeUndefined)({
         name: (0, utils_1.hexToString)(RemarkName),
-        value: decodeData(RemarkValue),
+        value: (0, utils_1.decodeHexData)(RemarkValue),
         flags: (0, remark_flags_1.default)(Flags),
     });
 }
-function decodeData(data) {
-    if (!data) {
-        return undefined;
-    }
-    const decoded = (0, utils_1.hexToString)(data);
-    if (decoded && decoded.includes("�")) {
-        return data;
-    }
-    return decoded;
-}

package/lib/parse/outcome/credential_changes.d.ts

@@ -0,0 +1,16 @@
+import { TransactionMetadata } from "xrpl";
+import { CredentialFlagsKeysInterface } from "../../types";
+interface FormattedCredentialSummaryInterface {
+    status?: "created" | "modified" | "deleted";
+    credentialIndex: string;
+    issuer?: string;
+    subject?: string;
+    credentialType?: string;
+    expiration?: number;
+    uri?: string;
+    flags?: CredentialFlagsKeysInterface;
+    previousTxnID?: string;
+    flagsChange?: CredentialFlagsKeysInterface;
+}
+declare function parseCredentialChanges(metadata: TransactionMetadata): FormattedCredentialSummaryInterface | undefined;
+export { parseCredentialChanges };

package/lib/parse/outcome/credential_changes.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCredentialChanges = parseCredentialChanges;
+const models_1 = require("../../models");
+const utils_1 = require("../utils");
+const credential_flags_1 = __importDefault(require("../ledger/credential-flags"));
+function parseCredentialStatus(node) {
+    if (node.diffType === "CreatedNode") {
+        return "created";
+    }
+    if (node.diffType === "ModifiedNode") {
+        return "modified";
+    }
+    if (node.diffType === "DeletedNode") {
+        return "deleted";
+    }
+    return undefined;
+}
+function summarizeCredential(node) {
+    const final = node.diffType === "CreatedNode" ? node.newFields : node.finalFields;
+    const prev = node.previousFields;
+    const summary = {
+        status: parseCredentialStatus(node),
+        credentialIndex: node.ledgerIndex,
+        issuer: final.Issuer,
+        subject: final.Subject,
+        credentialType: (0, utils_1.decodeHexData)(final.CredentialType),
+        flags: (0, credential_flags_1.default)(final.Flags, { excludeFalse: false }),
+    };
+    if (final.Expiration !== undefined) {
+        summary.expiration = (0, models_1.ledgerTimeToUnixTime)(final.Expiration);
+    }
+    if (final.URI !== undefined) {
+        summary.uri = final.URI;
+    }
+    if (node.diffType === "ModifiedNode") {
+        if (prev.Flags !== undefined) {
+            summary.flagsChange = (0, credential_flags_1.default)(prev.Flags, { excludeFalse: false });
+        }
+    }
+    if (node.PreviousTxnID) {
+        summary.previousTxnID = node.PreviousTxnID;
+    }
+    return summary;
+}
+function parseCredentialChanges(metadata) {
+    const affectedNodes = metadata.AffectedNodes.filter((affectedNode) => {
+        const node = affectedNode.CreatedNode || affectedNode.ModifiedNode || affectedNode.DeletedNode;
+        return node.LedgerEntryType === "Credential";
+    });
+    if (affectedNodes.length !== 1) {
+        return undefined;
+    }
+    const normalizedNode = (0, utils_1.normalizeNode)(affectedNodes[0]);
+    return summarizeCredential(normalizedNode);
+}

package/lib/parse/outcome/index.d.ts

@@ -18,5 +18,6 @@ export { parseOracleChanges } from "./oracle_changes";
 export { parseDeliveredAmount } from "./delivered_amount";
 export { parseMPTokenIssuanceChanges } from "./mptoken_issuance_changes";
 export { parseMPTokenChanges } from "./mptoken_changes";
+export { parseCredentialChanges } from "./credential_changes";
 export { parseDelegateChanges } from "./delegate_changes";
 export { parseRemarksChanges } from "./remarks_changes";

package/lib/parse/outcome/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseRemarksChanges = exports.parseDelegateChanges = exports.parseMPTokenChanges = exports.parseMPTokenIssuanceChanges = exports.parseDeliveredAmount = exports.parseOracleChanges = exports.parseDIDChanges = exports.parseAmmChanges = exports.parseUNLReportChanges = exports.parseEscrowChanges = exports.parseEmittedTxns = exports.parseHooksExecutions = exports.parseOrderbookChanges = exports.parseCheckChanges = exports.parseChannelChanges = exports.parseLockedBalanceChanges = exports.parseBalanceChanges = exports.parseURITokenSellOfferChanges = exports.parseURITokenChanges = exports.parseNFTokenOfferChanges = exports.parseNFTokenChanges = exports.parseAffectedObjects = void 0;
+exports.parseRemarksChanges = exports.parseDelegateChanges = exports.parseCredentialChanges = exports.parseMPTokenChanges = exports.parseMPTokenIssuanceChanges = exports.parseDeliveredAmount = exports.parseOracleChanges = exports.parseDIDChanges = exports.parseAmmChanges = exports.parseUNLReportChanges = exports.parseEscrowChanges = exports.parseEmittedTxns = exports.parseHooksExecutions = exports.parseOrderbookChanges = exports.parseCheckChanges = exports.parseChannelChanges = exports.parseLockedBalanceChanges = exports.parseBalanceChanges = exports.parseURITokenSellOfferChanges = exports.parseURITokenChanges = exports.parseNFTokenOfferChanges = exports.parseNFTokenChanges = exports.parseAffectedObjects = void 0;
 var affected_objects_1 = require("./affected_objects");
 Object.defineProperty(exports, "parseAffectedObjects", { enumerable: true, get: function () { return affected_objects_1.parseAffectedObjects; } });
 var nftoken_changes_1 = require("./nftoken_changes");
@@ -41,6 +41,8 @@ var mptoken_issuance_changes_1 = require("./mptoken_issuance_changes");
 Object.defineProperty(exports, "parseMPTokenIssuanceChanges", { enumerable: true, get: function () { return mptoken_issuance_changes_1.parseMPTokenIssuanceChanges; } });
 var mptoken_changes_1 = require("./mptoken_changes");
 Object.defineProperty(exports, "parseMPTokenChanges", { enumerable: true, get: function () { return mptoken_changes_1.parseMPTokenChanges; } });
+var credential_changes_1 = require("./credential_changes");
+Object.defineProperty(exports, "parseCredentialChanges", { enumerable: true, get: function () { return credential_changes_1.parseCredentialChanges; } });
 var delegate_changes_1 = require("./delegate_changes");
 Object.defineProperty(exports, "parseDelegateChanges", { enumerable: true, get: function () { return delegate_changes_1.parseDelegateChanges; } });
 var remarks_changes_1 = require("./remarks_changes");

package/lib/parse/outcome.js

@@ -36,6 +36,7 @@ const MPTOKEN_TYPES = [
     "Payment",
     "Clawback",
 ];
+const CREDENTIAL_TYPES = ["CredentialCreate", "CredentialAccept", "CredentialDelete"];
 const DELEGATE_TYPES = ["DelegateSet"];
 const REMARKS_TYPES = ["SetRemarks"];
 function parseOutcome(tx, nativeCurrency, definitions) {
@@ -64,6 +65,7 @@ function parseOutcome(tx, nativeCurrency, definitions) {
         oracleChanges: getOracleChanges(tx),
         mptokenIssuanceChanges: getMPTokenIssuanceChanges(tx, nativeCurrency || (0, client_1.getNativeCurrency)()),
         mptokenChanges: getMPTokenChanges(tx, nativeCurrency || (0, client_1.getNativeCurrency)()),
+        credentialChanges: getCredentialChanges(tx, nativeCurrency || (0, client_1.getNativeCurrency)()),
         delegateChanges: getDelegateChanges(tx, nativeCurrency || (0, client_1.getNativeCurrency)()),
         remarksChanges: getRemarksChanges(tx, nativeCurrency || (0, client_1.getNativeCurrency)()),
         unlReportChanges: getUNLReportChanges(tx, nativeCurrency || (0, client_1.getNativeCurrency)()),
@@ -202,6 +204,15 @@ function getMPTokenIssuanceChanges(tx, nativeCurrency) {
     const mptokenIssuanceChanges = (0, index_1.parseMPTokenIssuanceChanges)(tx);
     return Object.keys(mptokenIssuanceChanges).length > 0 ? mptokenIssuanceChanges : undefined;
 }
+function getCredentialChanges(tx, nativeCurrency) {
+    if (nativeCurrency !== "XRP") {
+        return undefined;
+    }
+    if (!CREDENTIAL_TYPES.includes(tx.TransactionType)) {
+        return undefined;
+    }
+    return (0, index_1.parseCredentialChanges)(tx.meta);
+}
 function getDelegateChanges(tx, nativeCurrency) {
     if (nativeCurrency !== "XRP") {
         return undefined;

package/lib/parse/specification/credential-accept.d.ts

@@ -0,0 +1,3 @@
+import { FormattedCredentialAcceptSpecification } from "../../types/credentials";
+declare function parseCredentialAccept(tx: any): FormattedCredentialAcceptSpecification;
+export default parseCredentialAccept;

package/lib/parse/specification/credential-accept.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert = __importStar(require("assert"));
+const common_1 = require("../../common");
+const memos_1 = require("../ledger/memos");
+const signers_1 = require("../ledger/signers");
+const regular_key_1 = require("../ledger/regular-key");
+const source_1 = require("../ledger/source");
+const utils_1 = require("../utils");
+function parseCredentialAccept(tx) {
+    assert.ok(tx.TransactionType === "CredentialAccept");
+    return (0, common_1.removeUndefined)({
+        source: (0, source_1.parseSource)(tx),
+        signers: (0, signers_1.parseSigners)(tx),
+        signer: (0, regular_key_1.parseSignerRegularKey)(tx),
+        issuer: tx.Issuer,
+        credentialType: (0, utils_1.hexToString)(tx.CredentialType),
+        memos: (0, memos_1.parseMemos)(tx),
+    });
+}
+exports.default = parseCredentialAccept;

package/lib/parse/specification/credential-create.d.ts

@@ -0,0 +1,3 @@
+import { FormattedCredentialCreateSpecification } from "../../types/credentials";
+declare function parseCredentialCreate(tx: any): FormattedCredentialCreateSpecification;
+export default parseCredentialCreate;

package/lib/parse/specification/credential-create.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert = __importStar(require("assert"));
+const common_1 = require("../../common");
+const memos_1 = require("../ledger/memos");
+const signers_1 = require("../ledger/signers");
+const regular_key_1 = require("../ledger/regular-key");
+const source_1 = require("../ledger/source");
+const utils_1 = require("../utils");
+function parseCredentialCreate(tx) {
+    assert.ok(tx.TransactionType === "CredentialCreate");
+    return (0, common_1.removeUndefined)({
+        source: (0, source_1.parseSource)(tx),
+        signers: (0, signers_1.parseSigners)(tx),
+        signer: (0, regular_key_1.parseSignerRegularKey)(tx),
+        subject: tx.Subject,
+        credentialType: (0, utils_1.decodeHexData)(tx.CredentialType),
+        expiration: tx.Expiration && (0, utils_1.parseTimestamp)(tx.Expiration),
+        uri: tx.URI,
+        memos: (0, memos_1.parseMemos)(tx),
+    });
+}
+exports.default = parseCredentialCreate;

package/lib/parse/specification/credential-delete.d.ts

@@ -0,0 +1,3 @@
+import { FormattedCredentialDeleteSpecification } from "../../types/credentials";
+declare function parseCredentialDelete(tx: any): FormattedCredentialDeleteSpecification;
+export default parseCredentialDelete;

package/lib/parse/specification/credential-delete.js

@@ -0,0 +1,55 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const assert = __importStar(require("assert"));
+const common_1 = require("../../common");
+const memos_1 = require("../ledger/memos");
+const signers_1 = require("../ledger/signers");
+const regular_key_1 = require("../ledger/regular-key");
+const source_1 = require("../ledger/source");
+const utils_1 = require("../utils");
+function parseCredentialDelete(tx) {
+    assert.ok(tx.TransactionType === "CredentialDelete");
+    return (0, common_1.removeUndefined)({
+        source: (0, source_1.parseSource)(tx),
+        signers: (0, signers_1.parseSigners)(tx),
+        signer: (0, regular_key_1.parseSignerRegularKey)(tx),
+        issuer: tx.issuer,
+        subject: tx.Subject,
+        credentialType: (0, utils_1.hexToString)(tx.CredentialType),
+        memos: (0, memos_1.parseMemos)(tx),
+    });
+}
+exports.default = parseCredentialDelete;

package/lib/parse/transaction.d.ts

@@ -22,13 +22,14 @@ import { FormattedAmmBidSpecification, FormattedAmmCreateSpecification, Formatte
 import { FormattedDIDSetSpecification, FormattedDIDDeleteSpecification } from "../types/did";
 import { FormattedOracleSetSpecification, FormattedOracleDeleteSpecification } from "../types/oracle";
 import { FormattedMPTokenIssuanceCreateSpecification, FormattedMPTokenAuthorizeSpecification, FormattedMPTokenIssuanceSetSpecification, FormattedMPTokenIssuanceDestroySpecification } from "../types/mptokens";
+import { FormattedCredentialCreateSpecification, FormattedCredentialAcceptSpecification, FormattedCredentialDeleteSpecification } from "../types/credentials";
 import { FormattedDelegateSetSpecification } from "../types/delegate";
 import { FormattedSetRemarksSpecification } from "../types/remarks";
 import { FormattedGenesisMintSpecification } from "../types/genesis_mint";
 import { FormattedAmendmentSpecification } from "../types/amendments";
 import { FormattedFeeUpdateSpecification } from "../types/fees";
 declare function parseTransactionType(type: string): string;
-export type FormattedSpecification = FormattedUnrecognizedParserSpecification | FormattedSettingsSpecification | FormattedAccountDeleteSpecification | FormattedCheckCancelSpecification | FormattedCheckCashSpecification | FormattedCheckCreateSpecification | FormattedDepositPreauthSpecification | FormattedEscrowCancelSpecification | FormattedEscrowCreateSpecification | FormattedEscrowFinishSpecification | FormattedOfferCancelSpecification | FormattedOfferCreateSpecification | FormattedPaymentSpecification | FormattedPaymentChannelClaimSpecification | FormattedPaymentChannelCreateSpecification | FormattedPaymentChannelFundSpecification | FormattedTicketCreateSpecification | FormattedTrustlineSpecification | FormattedNFTokenBurnSpecification | FormattedNFTokenMintSpecification | FormattedNFTokenModifySpecification | FormattedNFTokenCancelOfferSpecification | FormattedNFTokenCreateOfferSpecification | FormattedNFTokenAcceptOfferSpecification | FormattedURITokenBurnSpecification | FormattedURITokenBuySpecification | FormattedURITokenCreateSellOfferSpecification | FormattedURITokenCancelSellOfferSpecification | FormattedURITokenMintSpecification | FormattedImportSpecification | FormattedInvokeSpecification | FormattedUNLReportSpecification | FormattedRemitsSpecification | FormattedClawbackSpecification | FormattedAmmBidSpecification | FormattedAmmCreateSpecification | FormattedAmmDeleteSpecification | FormattedAmmDepositSpecification | FormattedAmmWithdrawSpecification | FormattedAmmVoteSpecification | FormattedAmmClawbackSpecification | FormattedGenesisMintSpecification | FormattedAmendmentSpecification | FormattedFeeUpdateSpecification | FormattedDIDSetSpecification | FormattedDIDDeleteSpecification | FormattedOracleSetSpecification | FormattedOracleDeleteSpecification | FormattedMPTokenIssuanceCreateSpecification | FormattedMPTokenAuthorizeSpecification | FormattedMPTokenIssuanceSetSpecification | FormattedMPTokenIssuanceDestroySpecification | FormattedDelegateSetSpecification | FormattedSetRemarksSpecification;
+export type FormattedSpecification = FormattedUnrecognizedParserSpecification | FormattedSettingsSpecification | FormattedAccountDeleteSpecification | FormattedCheckCancelSpecification | FormattedCheckCashSpecification | FormattedCheckCreateSpecification | FormattedDepositPreauthSpecification | FormattedEscrowCancelSpecification | FormattedEscrowCreateSpecification | FormattedEscrowFinishSpecification | FormattedOfferCancelSpecification | FormattedOfferCreateSpecification | FormattedPaymentSpecification | FormattedPaymentChannelClaimSpecification | FormattedPaymentChannelCreateSpecification | FormattedPaymentChannelFundSpecification | FormattedTicketCreateSpecification | FormattedTrustlineSpecification | FormattedNFTokenBurnSpecification | FormattedNFTokenMintSpecification | FormattedNFTokenModifySpecification | FormattedNFTokenCancelOfferSpecification | FormattedNFTokenCreateOfferSpecification | FormattedNFTokenAcceptOfferSpecification | FormattedURITokenBurnSpecification | FormattedURITokenBuySpecification | FormattedURITokenCreateSellOfferSpecification | FormattedURITokenCancelSellOfferSpecification | FormattedURITokenMintSpecification | FormattedImportSpecification | FormattedInvokeSpecification | FormattedUNLReportSpecification | FormattedRemitsSpecification | FormattedClawbackSpecification | FormattedAmmBidSpecification | FormattedAmmCreateSpecification | FormattedAmmDeleteSpecification | FormattedAmmDepositSpecification | FormattedAmmWithdrawSpecification | FormattedAmmVoteSpecification | FormattedAmmClawbackSpecification | FormattedGenesisMintSpecification | FormattedAmendmentSpecification | FormattedFeeUpdateSpecification | FormattedDIDSetSpecification | FormattedDIDDeleteSpecification | FormattedOracleSetSpecification | FormattedOracleDeleteSpecification | FormattedMPTokenIssuanceCreateSpecification | FormattedMPTokenAuthorizeSpecification | FormattedMPTokenIssuanceSetSpecification | FormattedMPTokenIssuanceDestroySpecification | FormattedCredentialCreateSpecification | FormattedCredentialAcceptSpecification | FormattedCredentialDeleteSpecification | FormattedDelegateSetSpecification | FormattedSetRemarksSpecification;
 export interface FormattedTransaction {
     type: string;
     address: string;

package/lib/parse/transaction.js

@@ -59,6 +59,9 @@ const mptoken_issuance_set_1 = __importDefault(require("./specification/mptoken-
 const mptoken_issuance_destroy_1 = __importDefault(require("./specification/mptoken-issuance-destroy"));
 const delegate_set_1 = __importDefault(require("./specification/delegate-set"));
 const set_remarks_1 = __importDefault(require("./specification/set-remarks"));
+const credential_create_1 = __importDefault(require("./specification/credential-create"));
+const credential_accept_1 = __importDefault(require("./specification/credential-accept"));
+const credential_delete_1 = __importDefault(require("./specification/credential-delete"));
 const genesis_mint_1 = __importDefault(require("./specification/genesis-mint"));
 const amendment_1 = __importDefault(require("./specification/amendment"));
 const fee_update_1 = __importDefault(require("./specification/fee-update"));
@@ -113,6 +116,9 @@ const transactionTypeToType = {
     MPTokenAuthorize: "MPTokenAuthorize",
     MPTokenIssuanceSet: "MPTokenIssuanceSet",
     MPTokenIssuanceDestroy: "MPTokenIssuanceDestroy",
+    CredentialCreate: "CredentialCreate",
+    CredentialAccept: "CredentialAccept",
+    CredentialDelete: "CredentialDelete",
     DelegateSet: "DelegateSet",
     SetRemarks: "SetRemarks",
     GenesisMint: "genesisMint",
@@ -171,6 +177,9 @@ const parserTypeFunc = {
     MPTokenAuthorize: mptoken_authorize_1.default,
     MPTokenIssuanceSet: mptoken_issuance_set_1.default,
     MPTokenIssuanceDestroy: mptoken_issuance_destroy_1.default,
+    CredentialCreate: credential_create_1.default,
+    CredentialAccept: credential_accept_1.default,
+    CredentialDelete: credential_delete_1.default,
     DelegateSet: delegate_set_1.default,
     SetRemarks: set_remarks_1.default,
     genesisMint: genesis_mint_1.default,

package/lib/parse/utils.d.ts

@@ -24,9 +24,10 @@ declare function removeGenericCounterparty(amount: IssuedCurrencyAmount | Format
 declare function normalizeNode(affectedNode: Node): NormalizedNode;
 declare function normalizeNodes(metadata: TransactionMetadata): NormalizedNode[];
 declare function hexToString(hex: string | undefined): string | undefined;
+declare function decodeHexData(data?: string): string | undefined;
 declare function stringToHex(value: string | undefined): string | undefined;
 declare function bytesToHex(value: Uint8Array | ArrayBufferLike): string;
 declare function hexToBytes(value: string): Uint8Array;
 declare function parseUint32(buf: Buffer, cur: number): string;
 declare function parseUint64(buf: Buffer, cur: number): string;
-export { NormalizedNode, parseQuality, parseTimestamp, adjustQualityForXRP, isPartialPayment, removeGenericCounterparty, normalizeNodes, normalizeNode, hexToString, stringToHex, bytesToHex, hexToBytes, parseUint32, parseUint64, };
+export { NormalizedNode, parseQuality, parseTimestamp, adjustQualityForXRP, isPartialPayment, removeGenericCounterparty, normalizeNodes, normalizeNode, hexToString, decodeHexData, stringToHex, bytesToHex, hexToBytes, parseUint32, parseUint64, };

package/lib/parse/utils.js

@@ -11,6 +11,7 @@ exports.removeGenericCounterparty = removeGenericCounterparty;
 exports.normalizeNodes = normalizeNodes;
 exports.normalizeNode = normalizeNode;
 exports.hexToString = hexToString;
+exports.decodeHexData = decodeHexData;
 exports.stringToHex = stringToHex;
 exports.bytesToHex = bytesToHex;
 exports.hexToBytes = hexToBytes;
@@ -72,11 +73,23 @@ function normalizeNodes(metadata) {
 function hexToString(hex) {
     return hex ? Buffer.from(hex, "hex").toString("utf-8") : undefined;
 }
+function decodeHexData(data) {
+    if (!data) {
+        return undefined;
+    }
+    const decoded = hexToString(data);
+    if (decoded && decoded.includes("�")) {
+        return data;
+    }
+    return decoded;
+}
 function stringToHex(value) {
     return value ? Buffer.from(value, "utf8").toString("hex").toUpperCase() : undefined;
 }
 function bytesToHex(value) {
-    return Buffer.from(value).toString("hex").toUpperCase();
+    return Buffer.from(value)
+        .toString("hex")
+        .toUpperCase();
 }
 function hexToBytes(value) {
     if (value.length % 2 !== 0) {

package/lib/types/credentials.d.ts

@@ -0,0 +1,25 @@
+import { FormattedBaseSpecification } from "./specification";
+export declare enum CredentialFlags {
+    lsfAccepted = 65536
+}
+export declare const CredentialFlagsKeys: {
+    accepted: CredentialFlags;
+};
+export interface CredentialFlagsKeysInterface {
+    accepted: boolean;
+}
+export type FormattedCredentialCreateSpecification = {
+    subject?: string;
+    credentialType?: string;
+    expiration?: number;
+    uri?: string;
+} & FormattedBaseSpecification;
+export type FormattedCredentialAcceptSpecification = {
+    issuer?: string;
+    credentialType?: string;
+} & FormattedBaseSpecification;
+export type FormattedCredentialDeleteSpecification = {
+    issuer?: string;
+    subject?: string;
+    credentialType?: string;
+} & FormattedBaseSpecification;

package/lib/types/credentials.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialFlagsKeys = exports.CredentialFlags = void 0;
+var CredentialFlags;
+(function (CredentialFlags) {
+    CredentialFlags[CredentialFlags["lsfAccepted"] = 65536] = "lsfAccepted";
+})(CredentialFlags || (exports.CredentialFlags = CredentialFlags = {}));
+exports.CredentialFlagsKeys = {
+    accepted: CredentialFlags.lsfAccepted,
+};

package/lib/types/index.d.ts

@@ -26,5 +26,6 @@ export * from "./invoke";
 export * from "./unl_reports";
 export * from "./remits";
 export * from "./hooks";
+export * from "./credentials";
 export * from "./delegate";
 export * from "./remarks";

package/lib/types/index.js

@@ -42,5 +42,6 @@ __exportStar(require("./invoke"), exports);
 __exportStar(require("./unl_reports"), exports);
 __exportStar(require("./remits"), exports);
 __exportStar(require("./hooks"), exports);
+__exportStar(require("./credentials"), exports);
 __exportStar(require("./delegate"), exports);
 __exportStar(require("./remarks"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bithomp/xrpl-api",
-  "version": "3.4.5",
+  "version": "3.5.0",
   "description": "A Bithomp JavaScript/TypeScript library for interacting with the XRP Ledger",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -43,7 +43,7 @@
     "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
     "lint": "eslint",
     "prepare": "npm run build",
-    "-prepublishOnly": "npm test && npm run lint",
+    "prepublishOnly": "npm test && npm run lint",
     "preversion": "npm run lint",
     "version": "npm run format && git add -A src",
     "postversion": "git push && git push --tags"