@koralabs/kora-labs-common 6.15.2 → 6.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koralabs/kora-labs-common",
-    "version": "6.15.2",
+    "version": "6.16.0",
     "description": "Kora Labs Common Utilities",
     "main": "index.js",
     "types": "index.d.ts",
@@ -77,7 +77,7 @@
         "@cardano-sdk/core": "^0.46.12 || ^0.47.0",
         "@cardano-sdk/crypto": "^0.4.5",
         "@emurgo/cardano-message-signing-nodejs": "^1.1.0",
-        "bip39": "^3.1.0",
+        "bip39": "^3.0.4",
         "cassandra-driver": "^4.9.0",
         "scalus": "^0.15.0"
     },

package/wallet/index.d.ts

@@ -0,0 +1,56 @@
+/** The CIP-30 API a dApp gets from `window.cardano[key].enable()` (plus the CIP-95/CIP-103 extensions). */
+export interface WalletApi {
+    getUtxos: () => Promise<string[] | null | undefined>;
+    getCollateral?: () => Promise<string[] | null>;
+    getExtensions?: () => Promise<{
+        cip: number;
+    }[]>;
+    getBalance: () => Promise<string>;
+    getNetworkId: () => Promise<number>;
+    getRewardAddresses: () => Promise<string[]>;
+    getChangeAddress: () => Promise<string>;
+    getUsedAddresses: () => Promise<string[]>;
+    getUnusedAddresses: () => Promise<string[]>;
+    signTx: (tx: string, partialSign?: boolean) => Promise<string>;
+    submitTx: (tx: string) => Promise<string>;
+    cip95?: {
+        getPubDRepKey: () => Promise<string>;
+    };
+    cip103?: {
+        signTxs: (txs: {
+            cbor: string;
+            partialSign?: boolean;
+        }[]) => Promise<string[]>;
+        submitTxs: (txs: string[]) => Promise<(string | {
+            error: unknown;
+        })[]>;
+    };
+}
+export interface WalletUtxoAsset {
+    policyId: string;
+    /** Asset name, hex (CIP-68 label included). */
+    hex: string;
+    count: number;
+}
+export interface ParsedUtxo {
+    /** The wallet's CBOR, untouched (ship this to a backend, never a re-encoding). */
+    cbor: string;
+    /** `<txHash>#<index>` */
+    id: string;
+    lovelace: bigint;
+    assets: WalletUtxoAsset[];
+}
+/**
+ * Parse one CIP-30 `getUtxos()` entry (`[input, output]` CBOR). Handles legacy array-form and
+ * Babbage map-form outputs (inline datum, reference script). Returns null for anything that is not
+ * a valid TransactionUnspentOutput, so one malformed entry never hides the rest of the wallet.
+ */
+export declare const parseUtxo: (cborHex: string) => ParsedUtxo | null;
+/** Lovelace in a CIP-30 `getBalance()` result (a CBOR `Value`: bare coin or `[coin, multiasset]`). Throws on malformed input. */
+export declare const lovelaceFromBalance: (balanceCborHex: string) => bigint;
+/**
+ * CIP-30 returns addresses as hex bytes. Shelley addresses (base, enterprise, pointer, reward) are
+ * returned in bech32 with the network's prefix; Byron addresses in base58. '' for empty input;
+ * throws on bytes that are not an address.
+ */
+export declare const addressHexToBech32: (addressHex: string) => string;

package/wallet/index.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addressHexToBech32 = exports.lovelaceFromBalance = exports.parseUtxo = void 0;
+// Subpath module: `@koralabs/kora-labs-common/wallet`. Isomorphic (browser + Node), no network.
+// Reads what a CIP-30 wallet returns (UTxO CBOR, balance CBOR, address hex) with
+// @cardano-sdk/core Serialization — never a hand-rolled or generic CBOR decoder.
+const core_1 = require("@cardano-sdk/core");
+const POLICY_ID_HEX_LENGTH = 56;
+const HexBlob = (hex) => hex;
+/**
+ * Parse one CIP-30 `getUtxos()` entry (`[input, output]` CBOR). Handles legacy array-form and
+ * Babbage map-form outputs (inline datum, reference script). Returns null for anything that is not
+ * a valid TransactionUnspentOutput, so one malformed entry never hides the rest of the wallet.
+ */
+const parseUtxo = (cborHex) => {
+    var _a;
+    const cbor = cborHex === null || cborHex === void 0 ? void 0 : cborHex.trim();
+    if (!cbor)
+        return null;
+    try {
+        const utxo = core_1.Serialization.TransactionUnspentOutput.fromCbor(HexBlob(cbor));
+        const input = utxo.input();
+        const value = utxo.output().amount();
+        const assets = [];
+        for (const [assetId, quantity] of (_a = value.multiasset()) !== null && _a !== void 0 ? _a : new Map()) {
+            assets.push({
+                policyId: assetId.slice(0, POLICY_ID_HEX_LENGTH),
+                hex: assetId.slice(POLICY_ID_HEX_LENGTH),
+                count: Number(quantity)
+            });
+        }
+        return { cbor, id: `${input.transactionId()}#${input.index()}`, lovelace: value.coin(), assets };
+    }
+    catch (_b) {
+        return null;
+    }
+};
+exports.parseUtxo = parseUtxo;
+/** Lovelace in a CIP-30 `getBalance()` result (a CBOR `Value`: bare coin or `[coin, multiasset]`). Throws on malformed input. */
+const lovelaceFromBalance = (balanceCborHex) => core_1.Serialization.Value.fromCbor(HexBlob(balanceCborHex)).coin();
+exports.lovelaceFromBalance = lovelaceFromBalance;
+/**
+ * CIP-30 returns addresses as hex bytes. Shelley addresses (base, enterprise, pointer, reward) are
+ * returned in bech32 with the network's prefix; Byron addresses in base58. '' for empty input;
+ * throws on bytes that are not an address.
+ */
+const addressHexToBech32 = (addressHex) => {
+    const hex = (addressHex !== null && addressHex !== void 0 ? addressHex : '').replace(/^0x/i, '');
+    if (!hex)
+        return '';
+    const address = core_1.Cardano.Address.fromBytes(HexBlob(hex));
+    return address.getType() === core_1.Cardano.AddressType.Byron ? address.toBase58() : address.toBech32();
+};
+exports.addressHexToBech32 = addressHexToBech32;