@joeywallet/gemwallet-compat 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joey Wallet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# @joeywallet/gemwallet-compat
+
+GemWallet's `@gemwallet/api` surface, implemented over
+[Joey Wallet](https://joeywallet.xyz). Migrate an existing GemWallet dapp by
+changing one import.
+
+```diff
+- import { isInstalled, getAddress, sendPayment } from '@gemwallet/api'
++ import { isInstalled, getAddress, sendPayment } from '@joeywallet/gemwallet-compat'
+```
+
+```bash
+npm install @joeywallet/gemwallet-compat
+```
+
+Function names, argument shapes and the `{ type, result }` envelope match
+`@gemwallet/api@3.8.0`. You can keep your existing `result.type === 'reject'`
+branches and your existing `try`/`catch` blocks.
+
+---
+
+## What is implemented
+
+| Function | Behaviour |
+| -------- | --------- |
+| `isInstalled()` | `{ result: { isInstalled } }`. Answers immediately when Joey is present, otherwise gives it GemWallet's 1-second budget. Never rejects. |
+| `getAddress()` | `{ type, result: { address } }`. Tries a silent connect first, then prompts if the origin is not yet authorised. |
+| `getPublicKey()` | `{ type, result: { address, publicKey } }`. Throws for a watch-only account. |
+| `getNetwork()` | `{ type, result: { chain, network, websocket } }` where `chain` is always `'XRPL'` and `network` is `Mainnet` / `Testnet` / `Devnet`. |
+| `sendPayment(payload)` | Builds a `Payment`, signs and submits. `{ type, result: { hash } }` |
+| `setTrustline(payload)` | Builds a `TrustSet`, signs and submits. `{ type, result: { hash } }` |
+| `signTransaction({ transaction })` | `{ type, result: { signature } }` — `signature` is the signed blob, as in GemWallet. |
+| `submitTransaction({ transaction })` | `{ type, result: { hash } }` |
+| `submitBulkTransactions({ transactions })` | `{ type, result: { transactions: [{ id?, accepted, hash? }] } }` |
+| `on(event, callback)` | `login`, `logout`, `networkChanged`, `walletChanged` |
+
+Payload field casing is GemWallet's, not XRPL's: `{ fee, sequence, memos: [{ memo: { memoData } }] }`
+is translated to `{ Fee, Sequence, Memos: [{ Memo: { MemoData } }] }` before
+signing.
+
+### Behavioural differences worth knowing
+
+- **`on()` returns an unsubscribe function.** `@gemwallet/api` returns `void`.
+  Existing call sites that ignore the return value are unaffected; SPAs that
+  re-subscribe on every route change now have a way to avoid leaking listeners.
+- **`on()` accepts both spellings.** `'login'` and the raw wire constant
+  `'EVENT_LOGIN'` both work, because `@gemwallet/api`'s implementation compares
+  against the latter while its documentation uses the former.
+- **`submitBulkTransactions` always aborts at the first failure.** `onError` is
+  accepted and ignored. `'abort'` is GemWallet's own default and the safer of
+  the two: `'continue'` would keep signing after a transaction the user or the
+  ledger already refused. Entries the aborted batch never reached come back as
+  `{ accepted: false }` with no `hash`, correlated to your `ID` by position.
+- **`getNetwork().websocket`** is the public endpoint for the chain Joey is on,
+  so it can still be fed to an xrpl.js `Client` the way GemWallet dapps do.
+
+---
+
+## What is deliberately **not** implemented
+
+`setRegularKey()`, `setHook()`, `setAccount()` and `signMessage()` throw
+`GemWalletUnsupportedError` (code `4200`) **synchronously**, so you find out at
+the first call in development rather than shipping a dead code path.
+
+### The three account-control transactions
+
+- **`SetRegularKey`** assigns an alternate signing key. Combined with
+  `AccountSet asfDisableMaster` it hands the holder permanent, unrevokable
+  control of the account — and the balance looks untouched while it drains over
+  later ledgers.
+- **`SetHook`** installs code that runs on every future transaction for the
+  account.
+- **`AccountSet`** can disable the master key, set an NFT minter, or change the
+  transfer rate.
+
+No approval dialog makes these safe, because the user cannot evaluate the
+consequence from the transaction JSON. Joey supports them from its own UI,
+behind a typed confirmation and step-up authentication, and the extension
+hard-rejects `SetRegularKey`, `SignerListSet` and `AccountDelete` at the
+deserialisation layer for any dapp-originated request — so routing one through
+`signTransaction()` or `submitTransaction()` by hand does not work either.
+
+```ts
+import { GemWalletUnsupportedError, setRegularKey } from '@joeywallet/gemwallet-compat'
+
+try {
+  await setRegularKey({ regularKey: 'r…' })
+} catch (error) {
+  if (error instanceof GemWalletUnsupportedError) {
+    // error.method  -> 'setRegularKey'
+    // error.code    -> 4200
+    showMessage('Change your account keys from the Joey Wallet extension.')
+  }
+}
+```
+
+### `signMessage`
+
+Joey has no raw message-signing method. A bare signature over an arbitrary
+string carries no domain, no nonce and no timestamp, so a signature a user
+produced on one site can be replayed against another. Use `signIn()` from
+[`@joeywallet/wallet-sdk`](../sdk) instead, which signs a CAIP-122 message bound to
+this origin and returns the exact string that was signed for your backend to
+verify:
+
+```ts
+import { requireJoey } from '@joeywallet/wallet-sdk'
+
+const { address, publicKey, signature, message } = await requireJoey().signIn({
+  statement: 'Sign in to Example',
+})
+```
+
+### NFT and offer helpers
+
+GemWallet's `mintNFT`, `createNFTOffer`, `acceptNFTOffer`, `cancelNFTOffer`,
+`burnNFT`, `getNFT`, `createOffer` and `cancelOffer` are not in this package.
+They carry no security objection — they are ordinary transactions — so build
+them with `submitTransaction({ transaction })`, or use `@joeywallet/wallet-sdk`
+directly.
+
+---
+
+## Once you have migrated
+
+This package exists to make the switch free, not to be the destination. When you
+have time, move to [`@joeywallet/wallet-sdk`](../sdk): promise rejections instead of a
+`{ type, result }` envelope, typed events, React hooks, multisign and bulk
+signing.
+
+```ts
+// @joeywallet/gemwallet-compat
+const result = await sendPayment({ amount: '1000000', destination })
+if (result.type === 'reject') return
+console.log(result.result?.hash)
+
+// @joeywallet/wallet-sdk
+const { hash } = await joey.signAndSubmitTransaction({
+  tx_json: {
+    TransactionType: 'Payment',
+    Account: address,
+    Destination: destination,
+    Amount: '1000000',
+  },
+})
+```

package/dist/convert.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GemWallet request shapes to XRPL transaction JSON.
+ *
+ * GemWallet's payloads are camelCase and its memo/signer wrappers are lowercase
+ * (`{ memo: { memoData } }`), while the ledger — and therefore everything Joey
+ * signs — uses XRPL's PascalCase field names. Every mapping here is mechanical;
+ * it is separated out because a mistake in it would show up as a transaction
+ * that silently loses a destination tag or a memo.
+ */
+import type { AnyTransaction, JoeyNetwork, Memo as XrplMemo, Signer as XrplSigner } from '@joeywallet/wallet-sdk';
+import type { BaseTransactionRequest, Memo as GemMemo, Network, SendPaymentRequest, SetTrustlineRequest, Signer as GemSigner } from './types.js';
+export declare function toXrplMemos(memos: GemMemo[] | undefined): XrplMemo[] | undefined;
+export declare function toXrplSigners(signers: GemSigner[] | undefined): XrplSigner[] | undefined;
+/** The fields every GemWallet transaction request shares. */
+export declare function toXrplCommonFields(request: BaseTransactionRequest): Record<string, unknown>;
+/**
+ * GemWallet's `sendPayment` payload as an XRPL `Payment`.
+ *
+ * **`amount` crosses untouched, and that is correct — checked, not assumed.**
+ * It is the one line in this package where being wrong costs a factor of a
+ * million, so the source is named rather than trusted to memory:
+ * `@gemwallet/api@3.8.0` types `SendPaymentRequest.amount` as xrpl.js's
+ * `Amount`, and `packages/constants/src/payload/payload.types.ts` documents it
+ * verbatim as *"A string representing the number of XRP to deliver, in drops."*
+ * Joey's `Payment.Amount` is drops. Same unit, no conversion, and a converting
+ * shim here would be the bug rather than the fix.
+ *
+ * The one place GemWallet does convert is its extension's `parseAmount`, and
+ * only for its deprecated v1 URL-parameter path, where `amount` arrives as a
+ * *number* of XRP. That path is not this API and never reaches this function:
+ * `amount` here is a `string` or an issued-currency object, both of which
+ * GemWallet forwards to the ledger exactly as this does.
+ *
+ * `convert.test.ts` pins both halves — drops for XRP, `value` untouched for an
+ * issued currency — so a future "helpful" `xrpToDrops` fails a test instead of
+ * a user's payment.
+ */
+export declare function toPaymentTransaction(request: SendPaymentRequest, account?: string): AnyTransaction;
+export declare function toTrustSetTransaction(request: SetTrustlineRequest, account?: string): AnyTransaction;
+/**
+ * Joey's network to GemWallet's `Network` string.
+ *
+ * GemWallet also has `Custom`, which Joey never returns: the extension ships a
+ * fixed set of three endpoints.
+ */
+export declare function toGemNetwork(network: JoeyNetwork): Network;
+export declare function toGemWebsocket(network: JoeyNetwork): string;
+/** GemWallet's human-readable network description, for the event payload. */
+export declare function toGemNetworkDescription(network: JoeyNetwork): string;
+//# sourceMappingURL=convert.d.ts.map

package/dist/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,IAAI,IAAI,QAAQ,EAChB,MAAM,IAAI,UAAU,EACrB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EACV,sBAAsB,EACtB,IAAI,IAAI,OAAO,EACf,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,IAAI,SAAS,EACpB,MAAM,YAAY,CAAA;AAWnB,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,GAAG,SAAS,CAShF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,UAAU,EAAE,GAAG,SAAS,CASxF;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc3F;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAiBhB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAYhB;AAgCD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAE1D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEpE"}

package/dist/convert.js

@@ -0,0 +1,143 @@
+/** Drops keys whose value is `undefined` so the wire message stays minimal. */
+function defined(source) {
+    const out = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+export function toXrplMemos(memos) {
+    if (memos === undefined)
+        return undefined;
+    return memos.map((entry) => ({
+        Memo: defined({
+            MemoData: entry.memo.memoData,
+            MemoType: entry.memo.memoType,
+            MemoFormat: entry.memo.memoFormat,
+        }),
+    }));
+}
+export function toXrplSigners(signers) {
+    if (signers === undefined)
+        return undefined;
+    return signers.map((entry) => ({
+        Signer: {
+            Account: entry.signer.account,
+            TxnSignature: entry.signer.txnSignature,
+            SigningPubKey: entry.signer.signingPubKey,
+        },
+    }));
+}
+/** The fields every GemWallet transaction request shares. */
+export function toXrplCommonFields(request) {
+    return defined({
+        Fee: request.fee,
+        Sequence: request.sequence,
+        AccountTxnID: request.accountTxnID,
+        LastLedgerSequence: request.lastLedgerSequence,
+        Memos: toXrplMemos(request.memos),
+        NetworkID: request.networkID,
+        Signers: toXrplSigners(request.signers),
+        SourceTag: request.sourceTag,
+        SigningPubKey: request.signingPubKey,
+        TicketSequence: request.ticketSequence,
+        TxnSignature: request.txnSignature,
+    });
+}
+/**
+ * GemWallet's `sendPayment` payload as an XRPL `Payment`.
+ *
+ * **`amount` crosses untouched, and that is correct — checked, not assumed.**
+ * It is the one line in this package where being wrong costs a factor of a
+ * million, so the source is named rather than trusted to memory:
+ * `@gemwallet/api@3.8.0` types `SendPaymentRequest.amount` as xrpl.js's
+ * `Amount`, and `packages/constants/src/payload/payload.types.ts` documents it
+ * verbatim as *"A string representing the number of XRP to deliver, in drops."*
+ * Joey's `Payment.Amount` is drops. Same unit, no conversion, and a converting
+ * shim here would be the bug rather than the fix.
+ *
+ * The one place GemWallet does convert is its extension's `parseAmount`, and
+ * only for its deprecated v1 URL-parameter path, where `amount` arrives as a
+ * *number* of XRP. That path is not this API and never reaches this function:
+ * `amount` here is a `string` or an issued-currency object, both of which
+ * GemWallet forwards to the ledger exactly as this does.
+ *
+ * `convert.test.ts` pins both halves — drops for XRP, `value` untouched for an
+ * issued currency — so a future "helpful" `xrpToDrops` fails a test instead of
+ * a user's payment.
+ */
+export function toPaymentTransaction(request, account) {
+    return {
+        TransactionType: 'Payment',
+        ...(account === undefined ? {} : { Account: account }),
+        ...toXrplCommonFields(request),
+        ...defined({
+            // Drops. See the note above before changing this.
+            Amount: request.amount,
+            Destination: request.destination,
+            DestinationTag: request.destinationTag,
+            InvoiceID: request.invoiceID,
+            Paths: request.paths,
+            SendMax: request.sendMax,
+            DeliverMin: request.deliverMin,
+            Flags: request.flags,
+        }),
+    };
+}
+export function toTrustSetTransaction(request, account) {
+    return {
+        TransactionType: 'TrustSet',
+        ...(account === undefined ? {} : { Account: account }),
+        ...toXrplCommonFields(request),
+        ...defined({
+            LimitAmount: request.limitAmount,
+            QualityIn: request.qualityIn,
+            QualityOut: request.qualityOut,
+            Flags: request.flags,
+        }),
+    };
+}
+/* ------------------------------------------------------------------ networks */
+/**
+ * The public endpoints for each chain.
+ *
+ * Duplicated from the extension's `shared/types.ts` `NETWORKS` rather than
+ * imported: this package is published to npm and cannot depend on the
+ * extension's source. GemWallet's `getNetwork()` contract promises a
+ * `websocket`, and dapps feed it straight into an xrpl.js `Client`, so
+ * answering with an empty string would break every migrating caller. They must
+ * be kept in step with the extension if an endpoint ever moves.
+ */
+const WEBSOCKET_BY_CHAIN = {
+    'xrpl:0': 'wss://s1.ripple.com/',
+    'xrpl:1': 'wss://testnet.xrpl-labs.com/',
+    'xrpl:2': 'wss://s.devnet.rippletest.net:51233/',
+};
+const GEM_NAME_BY_CHAIN = {
+    'xrpl:0': 'Mainnet',
+    'xrpl:1': 'Testnet',
+    'xrpl:2': 'Devnet',
+};
+const DESCRIPTION_BY_CHAIN = {
+    'xrpl:0': 'Main XRPL network',
+    'xrpl:1': 'XRPL Testnet',
+    'xrpl:2': 'XRPL Devnet',
+};
+/**
+ * Joey's network to GemWallet's `Network` string.
+ *
+ * GemWallet also has `Custom`, which Joey never returns: the extension ships a
+ * fixed set of three endpoints.
+ */
+export function toGemNetwork(network) {
+    return GEM_NAME_BY_CHAIN[network.chain];
+}
+export function toGemWebsocket(network) {
+    return WEBSOCKET_BY_CHAIN[network.chain];
+}
+/** GemWallet's human-readable network description, for the event payload. */
+export function toGemNetworkDescription(network) {
+    return DESCRIPTION_BY_CHAIN[network.chain];
+}
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../src/convert.ts"],"names":[],"mappings":"AA0BA,+EAA+E;AAC/E,SAAS,OAAO,CAAoC,MAAS;IAC3D,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC3C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA4B;IACtD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,OAAO,CAAC;YACZ,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;YAC7B,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;YAC7B,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU;SAClC,CAAqB;KACvB,CAAC,CAAC,CAAA;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgC;IAC5D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7B,MAAM,EAAE;YACN,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;YACvC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,aAAa;SAC1C;KACF,CAAC,CAAC,CAAA;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,OAA+B;IAChE,OAAO,OAAO,CAAC;QACb,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA2B,EAC3B,OAAgB;IAEhB,OAAO;QACL,eAAe,EAAE,SAAS;QAC1B,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACtD,GAAG,kBAAkB,CAAC,OAAO,CAAC;QAC9B,GAAG,OAAO,CAAC;YACT,kDAAkD;YAClD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC;KACe,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA4B,EAC5B,OAAgB;IAEhB,OAAO;QACL,eAAe,EAAE,UAAU;QAC3B,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACtD,GAAG,kBAAkB,CAAC,OAAO,CAAC;QAC9B,GAAG,OAAO,CAAC;YACT,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC;KACe,CAAA;AACrB,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;GASG;AACH,MAAM,kBAAkB,GAA8B;IACpD,QAAQ,EAAE,sBAAsB;IAChC,QAAQ,EAAE,8BAA8B;IACxC,QAAQ,EAAE,sCAAsC;CACjD,CAAA;AAED,MAAM,iBAAiB,GAA+B;IACpD,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,QAAQ;CACnB,CAAA;AAED,MAAM,oBAAoB,GAA8B;IACtD,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,aAAa;CACxB,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAoB;IACjD,OAAO,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC1C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,uBAAuB,CAAC,OAAoB;IAC1D,OAAO,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC5C,CAAC"}

package/dist/envelope.d.ts

@@ -0,0 +1,10 @@
+import type { BaseResponse } from './types.js';
+export declare function response<T>(result: T): BaseResponse<T> & {
+    type: 'response';
+    result: T;
+};
+export declare function rejected<T>(): BaseResponse<T> & {
+    type: 'reject';
+};
+export declare function envelope<T>(run: () => Promise<T>): Promise<BaseResponse<T>>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAExF;AAED,wBAAgB,QAAQ,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAElE;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAOjF"}

package/dist/envelope.js

@@ -0,0 +1,29 @@
+/**
+ * GemWallet's `{ type, result }` envelope, reconstructed on top of Joey's
+ * promise-rejection API.
+ *
+ * The two models disagree about exactly one thing, and this file is where that
+ * disagreement is resolved: GemWallet reports a user declining as a *resolved*
+ * `{ type: 'reject' }`, and reports everything else by throwing. Joey rejects
+ * with a `JoeyRpcError` in both cases. So a 4001 becomes `{ type: 'reject' }`
+ * and every other code is rethrown, which is what a GemWallet dapp's existing
+ * `if (result.type === 'reject')` branch and its `try`/`catch` already expect.
+ */
+import { JoeyRpcError, isUserRejection } from '@joeywallet/wallet-sdk';
+export function response(result) {
+    return { type: 'response', result };
+}
+export function rejected() {
+    return { type: 'reject', result: undefined };
+}
+export async function envelope(run) {
+    try {
+        return response(await run());
+    }
+    catch (cause) {
+        if (isUserRejection(cause))
+            return rejected();
+        throw JoeyRpcError.from(cause);
+    }
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAItE,MAAM,UAAU,QAAQ,CAAI,MAAS;IACnC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,GAAqB;IACrD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,eAAe,CAAC,KAAK,CAAC;YAAE,OAAO,QAAQ,EAAK,CAAA;QAChD,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+import type { GemEventPayloadMap, GemEventType, GetAddressResponse, GetNetworkResponse, GetPublicKeyResponse, IsInstalledResponse, SendPaymentRequest, SendPaymentResponse, SetTrustlineRequest, SetTrustlineResponse, SignMessageResponse, SignTransactionRequest, SignTransactionResponse, SubmitBulkTransactionsRequest, SubmitBulkTransactionsResponse, SubmitTransactionRequest, SubmitTransactionResponse } from './types.js';
+/**
+ * Never rejects, and answers immediately when the provider is already present.
+ *
+ * Matches GemWallet's contract, including its 1-second budget for a provider
+ * that has not been injected yet.
+ */
+export declare function isInstalled(): Promise<IsInstalledResponse>;
+export declare function getAddress(): Promise<GetAddressResponse>;
+export declare function getPublicKey(): Promise<GetPublicKeyResponse>;
+export declare function getNetwork(): Promise<GetNetworkResponse>;
+/**
+ * Not implemented. Throws {@link GemWalletUnsupportedError} synchronously.
+ *
+ * Joey has no raw message-signing method: a bare signature over a string
+ * carries no domain, nonce or timestamp and is replayable against another site.
+ * Use `signIn()` from `@joeywallet/wallet-sdk`, which signs a CAIP-122 message bound
+ * to this origin.
+ */
+export declare function signMessage(_message: string, _isHex?: boolean): Promise<SignMessageResponse>;
+export declare function sendPayment(paymentPayload: SendPaymentRequest): Promise<SendPaymentResponse>;
+export declare function setTrustline(payload: SetTrustlineRequest): Promise<SetTrustlineResponse>;
+export declare function signTransaction(payload: SignTransactionRequest): Promise<SignTransactionResponse>;
+export declare function submitTransaction(payload: SubmitTransactionRequest): Promise<SubmitTransactionResponse>;
+export declare function submitBulkTransactions(payload: SubmitBulkTransactionsRequest): Promise<SubmitBulkTransactionsResponse>;
+/**
+ * Not implemented. Throws {@link GemWalletUnsupportedError} synchronously.
+ *
+ * @see ./unsupported.ts for why.
+ */
+export declare function setRegularKey(_payload?: unknown): Promise<never>;
+/** Not implemented. Throws {@link GemWalletUnsupportedError} synchronously. */
+export declare function setHook(_payload?: unknown): Promise<never>;
+/** Not implemented. Throws {@link GemWalletUnsupportedError} synchronously. */
+export declare function setAccount(_payload?: unknown): Promise<never>;
+type NormalisedEvent<E extends GemEventType> = E extends 'login' | 'EVENT_LOGIN' ? 'login' : E extends 'logout' | 'EVENT_LOGOUT' ? 'logout' : E extends 'networkChanged' | 'EVENT_NETWORK_CHANGED' ? 'networkChanged' : E extends 'walletChanged' | 'EVENT_WALLET_CHANGED' ? 'walletChanged' : never;
+/**
+ * Subscribe to a wallet event.
+ *
+ * `@gemwallet/api`'s `on()` returns `void`; this returns an unsubscribe
+ * function. That is a superset — existing call sites that ignore the return
+ * value are unaffected — and it is what a single-page app needs to avoid
+ * leaking a listener on every route change.
+ */
+export declare function on<E extends GemEventType>(eventType: E, callback: (payload: GemEventPayloadMap[NormalisedEvent<E>]) => void): () => void;
+export { GemWalletUnsupportedError, UNSUPPORTED_METHODS, type UnsupportedMethod, } from './unsupported.js';
+export { envelope, rejected, response } from './envelope.js';
+export { toGemNetwork, toGemWebsocket, toPaymentTransaction, toTrustSetTransaction, toXrplMemos, toXrplSigners, } from './convert.js';
+export { DEFAULT_SUBMIT_TX_BULK_ON_ERROR } from './types.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAKV,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EAE1B,MAAM,YAAY,CAAA;AA4CnB;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAQhE;AAID,wBAAsB,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAK9D;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAWlE;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAW9D;AAID;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE5F;AAED,wBAAsB,WAAW,CAC/B,cAAc,EAAE,kBAAkB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAQ9B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAQ/B;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAMpC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,8BAA8B,CAAC,CAwCzC;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAEhE;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAE1D;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAE7D;AAID,KAAK,eAAe,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,SAAS,OAAO,GAAG,aAAa,GAC5E,OAAO,GACP,CAAC,SAAS,QAAQ,GAAG,cAAc,GACjC,QAAQ,GACR,CAAC,SAAS,gBAAgB,GAAG,uBAAuB,GAClD,gBAAgB,GAChB,CAAC,SAAS,eAAe,GAAG,sBAAsB,GAChD,eAAe,GACf,KAAK,CAAA;AAwDf;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,CAAC,SAAS,YAAY,EACvC,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAClE,MAAM,IAAI,CAyBZ;AAID,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAA;AAC5D,mBAAmB,YAAY,CAAA"}