@dynamic-labs-sdk/stellar 0.0.0 → 1.16.1

package/dist/utils/buildPaymentTransaction/buildPaymentTransaction.d.ts

@@ -0,0 +1,22 @@
+import { type Asset, type Horizon, type Transaction } from '@stellar/stellar-sdk';
+type BuildPaymentTransactionParams = {
+    amount: string;
+    asset: Asset;
+    networkPassphrase: string;
+    recipient: string;
+    sourceAccount: Horizon.AccountResponse;
+};
+/**
+ * Builds a Stellar payment transaction sending `amount` of `asset` from the
+ * source account to the recipient.
+ *
+ * @param amount - Amount to send, as a decimal string in the asset's units.
+ * @param asset - The asset to send (native or custom).
+ * @param networkPassphrase - The network passphrase to sign against.
+ * @param recipient - The destination account address.
+ * @param sourceAccount - The sender's account loaded from Horizon.
+ * @notInstrumented
+ */
+export declare const buildPaymentTransaction: ({ amount, asset, networkPassphrase, recipient, sourceAccount, }: BuildPaymentTransactionParams) => Transaction;
+export {};
+//# sourceMappingURL=buildPaymentTransaction.d.ts.map

package/dist/utils/buildPaymentTransaction/buildPaymentTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPaymentTransaction.d.ts","sourceRoot":"","sources":["../../../src/utils/buildPaymentTransaction/buildPaymentTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,OAAO,EAEZ,KAAK,WAAW,EAEjB,MAAM,sBAAsB,CAAC;AAI9B,KAAK,6BAA6B,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,oEAMjC,6BAA6B,KAAG,WAavB,CAAC"}

package/dist/utils/buildPaymentTransaction/index.d.ts

@@ -0,0 +1,2 @@
+export { buildPaymentTransaction } from './buildPaymentTransaction';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/buildPaymentTransaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/buildPaymentTransaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/utils/checkTrustline/checkTrustline.d.ts

@@ -0,0 +1,17 @@
+import type { Asset, Horizon } from '@stellar/stellar-sdk';
+type CheckTrustlineParams = {
+    account: Horizon.AccountResponse;
+    asset: Asset;
+};
+/**
+ * Returns whether an account can receive the given asset. The native asset
+ * (XLM) never needs a trustline; non-native assets require a matching
+ * credit balance (trustline) on the account.
+ *
+ * @param account - The destination account loaded from Horizon.
+ * @param asset - The asset being sent.
+ * @notInstrumented
+ */
+export declare const checkTrustline: ({ account, asset, }: CheckTrustlineParams) => boolean;
+export {};
+//# sourceMappingURL=checkTrustline.d.ts.map

package/dist/utils/checkTrustline/checkTrustline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkTrustline.d.ts","sourceRoot":"","sources":["../../../src/utils/checkTrustline/checkTrustline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE3D,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,wBAGxB,oBAAoB,KAAG,OAezB,CAAC"}

package/dist/utils/checkTrustline/index.d.ts

@@ -0,0 +1,2 @@
+export { checkTrustline } from './checkTrustline';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/checkTrustline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/checkTrustline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/constants.d.ts

@@ -0,0 +1,29 @@
+import type { StellarNetworkName } from '../StellarProvider.types';
+/**
+ * Stellar network passphrase for mainnet
+ */
+export declare const STELLAR_PUBLIC_NETWORK_PASSPHRASE = "Public Global Stellar Network ; September 2015";
+/**
+ * Stellar network passphrase for testnet
+ */
+export declare const STELLAR_TESTNET_NETWORK_PASSPHRASE = "Test SDF Network ; September 2015";
+/**
+ * Stellar network passphrase for futurenet
+ */
+export declare const STELLAR_FUTURENET_NETWORK_PASSPHRASE = "Test SDF Future Network ; October 2022";
+/**
+ * Number of stroops per XLM (1 XLM = 10,000,000 stroops)
+ */
+export declare const STROOPS_PER_XLM = 10000000;
+/**
+ * Network passphrase keyed by Stellar network name. The SDK's network
+ * identifier (chain ID) is the SHA-256 hash of these passphrases.
+ */
+export declare const STELLAR_PASSPHRASE_BY_NAME: Record<StellarNetworkName, string>;
+/**
+ * Public Horizon server URL keyed by Stellar network name. Transaction
+ * submission must target a write-capable Horizon server (not an arbitrary RPC
+ * URL, which returns 405 on POST /transactions).
+ */
+export declare const STELLAR_HORIZON_URL_BY_NAME: Record<StellarNetworkName, string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,iCAAiC,mDACI,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,kCAAkC,sCACV,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,oCAAoC,2CACP,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,eAAe,WAAM,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAIzE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAI1E,CAAC"}

package/dist/utils/createPaymentAsset/createPaymentAsset.d.ts

@@ -0,0 +1,15 @@
+import { Asset } from '@stellar/stellar-sdk';
+type CreatePaymentAssetParams = {
+    code: string;
+    issuer: string;
+};
+/**
+ * Creates a Stellar Asset for a payment operation. Returns the native asset
+ * (XLM) when no code/issuer is provided, otherwise a custom asset.
+ *
+ * @param asset - Optional `{ code, issuer }` for a non-native asset.
+ * @notInstrumented
+ */
+export declare const createPaymentAsset: (asset?: CreatePaymentAssetParams) => Asset;
+export {};
+//# sourceMappingURL=createPaymentAsset.d.ts.map

package/dist/utils/createPaymentAsset/createPaymentAsset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPaymentAsset.d.ts","sourceRoot":"","sources":["../../../src/utils/createPaymentAsset/createPaymentAsset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,KAAK,wBAAwB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,WAAY,wBAAwB,KAAG,KACR,CAAC"}

package/dist/utils/createPaymentAsset/index.d.ts

@@ -0,0 +1,2 @@
+export { createPaymentAsset } from './createPaymentAsset';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/createPaymentAsset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/createPaymentAsset/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/utils/createStellarNetworkProvider/createStellarNetworkProvider.d.ts

@@ -0,0 +1,10 @@
+import type { NetworkData } from '@dynamic-labs-sdk/client';
+import type { StellarNetworkProvider } from '../../StellarNetworkProvider.types';
+/**
+ * Creates a Stellar network provider from network data.
+ *
+ * @param networkData - The network data for the Stellar network.
+ * @notInstrumented
+ */
+export declare const createStellarNetworkProvider: (networkData: NetworkData) => StellarNetworkProvider;
+//# sourceMappingURL=createStellarNetworkProvider.d.ts.map

package/dist/utils/createStellarNetworkProvider/createStellarNetworkProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStellarNetworkProvider.d.ts","sourceRoot":"","sources":["../../../src/utils/createStellarNetworkProvider/createStellarNetworkProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAGjF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,gBAC1B,WAAW,KACvB,sBASD,CAAC"}

package/dist/utils/createStellarNetworkProvider/index.d.ts

@@ -0,0 +1,2 @@
+export { createStellarNetworkProvider } from './createStellarNetworkProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/createStellarNetworkProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/createStellarNetworkProvider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/utils/fetchStellarBalance/fetchStellarBalance.d.ts

@@ -0,0 +1,17 @@
+import type { NetworkData } from '@dynamic-labs-sdk/client';
+type FetchStellarBalanceParams = {
+    address: string;
+    networkData: NetworkData;
+};
+/**
+ * Fetches the native XLM balance for an address from Horizon.
+ * Returns '0' when the account has no native balance, and throws a
+ * FetchStellarBalanceError when the balance cannot be retrieved.
+ *
+ * @param address - The Stellar public key.
+ * @param networkData - Network data carrying the Horizon RPC URL.
+ * @notInstrumented
+ */
+export declare const fetchStellarBalance: ({ address, networkData, }: FetchStellarBalanceParams) => Promise<string>;
+export {};
+//# sourceMappingURL=fetchStellarBalance.d.ts.map

package/dist/utils/fetchStellarBalance/fetchStellarBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchStellarBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchStellarBalance/fetchStellarBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,KAAK,yBAAyB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,8BAG7B,yBAAyB,KAAG,OAAO,CAAC,MAAM,CAsB5C,CAAC"}

package/dist/utils/fetchStellarBalance/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchStellarBalance } from './fetchStellarBalance';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/fetchStellarBalance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchStellarBalance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/utils/getNetworkPassphrase/getNetworkPassphrase.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Gets the network passphrase for a given Dynamic Stellar network id (the
+ * SHA-256 hash of a network passphrase). Defaults to the public network when
+ * the id is unknown.
+ *
+ * @param networkId - The network id (hex SHA-256 hash of the passphrase).
+ * @returns The matching network passphrase.
+ * @notInstrumented
+ */
+export declare const getNetworkPassphrase: ({ networkId, }: {
+    networkId: string | undefined;
+}) => string;
+//# sourceMappingURL=getNetworkPassphrase.d.ts.map

package/dist/utils/getNetworkPassphrase/getNetworkPassphrase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNetworkPassphrase.d.ts","sourceRoot":"","sources":["../../../src/utils/getNetworkPassphrase/getNetworkPassphrase.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,mBAE9B;IACD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,KAAG,MAGoC,CAAC"}

package/dist/utils/getNetworkPassphrase/index.d.ts

@@ -0,0 +1,2 @@
+export { getNetworkPassphrase } from './getNetworkPassphrase';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/getNetworkPassphrase/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/getNetworkPassphrase/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/utils/getStellarNetworkId/getStellarNetworkId.d.ts

@@ -0,0 +1,22 @@
+type GetStellarNetworkIdParams = {
+    network: string;
+};
+/**
+ * Maps a wallet-reported Stellar network (name or passphrase) to its Dynamic
+ * network identifier: the hex-encoded SHA-256 hash of the network passphrase
+ * (Stellar's canonical Network ID), which is how the backend identifies the
+ * network.
+ *
+ * @param network - Raw network value reported by the wallet.
+ * @returns The hex SHA-256 hash of the network passphrase.
+ *
+ * @example
+ * ```typescript
+ * // pubnet -> 7ac33997544e3175d266bd022439b22cdb16508c01163f26e5cb2a3e1045a979
+ * getStellarNetworkId({ network: 'PUBLIC' });
+ * ```
+ * @notInstrumented
+ */
+export declare const getStellarNetworkId: ({ network, }: GetStellarNetworkIdParams) => string;
+export {};
+//# sourceMappingURL=getStellarNetworkId.d.ts.map

package/dist/utils/getStellarNetworkId/getStellarNetworkId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStellarNetworkId.d.ts","sourceRoot":"","sources":["../../../src/utils/getStellarNetworkId/getStellarNetworkId.ts"],"names":[],"mappings":"AAMA,KAAK,yBAAyB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,iBAE7B,yBAAyB,KAAG,MAK9B,CAAC"}

package/dist/utils/getStellarNetworkId/index.d.ts

@@ -0,0 +1,2 @@
+export { getStellarNetworkId } from './getStellarNetworkId';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/getStellarNetworkId/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/getStellarNetworkId/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/utils/normalizeNetworkName/index.d.ts

@@ -0,0 +1,2 @@
+export { normalizeNetworkName } from './normalizeNetworkName';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/normalizeNetworkName/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/normalizeNetworkName/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/utils/normalizeNetworkName/normalizeNetworkName.d.ts

@@ -0,0 +1,21 @@
+import type { StellarNetworkName } from '../../StellarProvider.types';
+type NormalizeNetworkNameParams = {
+    network: string;
+};
+/**
+ * Normalize network name to standard format
+ *
+ * @param network - Raw network name from wallet
+ * @returns Normalized network name (PUBLIC, TESTNET, or FUTURENET)
+ *
+ * @example
+ * ```typescript
+ * normalizeNetworkName({ network: 'mainnet' }) // 'PUBLIC'
+ * normalizeNetworkName({ network: 'testnet' }) // 'TESTNET'
+ * normalizeNetworkName({ network: 'Test SDF Network ; September 2015' }) // 'TESTNET'
+ * ```
+ * @notInstrumented
+ */
+export declare const normalizeNetworkName: ({ network, }: NormalizeNetworkNameParams) => StellarNetworkName;
+export {};
+//# sourceMappingURL=normalizeNetworkName.d.ts.map

package/dist/utils/normalizeNetworkName/normalizeNetworkName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeNetworkName.d.ts","sourceRoot":"","sources":["../../../src/utils/normalizeNetworkName/normalizeNetworkName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,KAAK,0BAA0B,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,iBAE9B,0BAA0B,KAAG,kBAoB/B,CAAC"}

package/dist/utils/stellarTransferAmount/index.d.ts

@@ -0,0 +1,2 @@
+export { stellarTransferAmount } from './stellarTransferAmount';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/stellarTransferAmount/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/stellarTransferAmount/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/utils/stellarTransferAmount/stellarTransferAmount.d.ts

@@ -0,0 +1,22 @@
+import { type DynamicClient } from '@dynamic-labs-sdk/client';
+import { type TransferAmountParams } from '@dynamic-labs-sdk/client/core';
+/**
+ * Transfers native XLM or a custom Stellar asset from a wallet account.
+ *
+ * A custom asset is identified by `token.address` in the form `CODE:ISSUER`
+ * (or `CODE-ISSUER`). Amounts are decimal strings in the asset's display
+ * units. The destination account must exist, and for non-native assets it must
+ * already hold a trustline for the asset.
+ *
+ * @param amount - Amount to send, as a decimal string (e.g. "1.5").
+ * @param recipient - Destination Stellar account address.
+ * @param token - Optional non-native asset (`address: "CODE:ISSUER"`).
+ * @param walletAccount - The Stellar wallet account to send from.
+ * @param client - The Dynamic client instance.
+ * @returns The submitted transaction hash.
+ * @notInstrumented
+ */
+export declare const stellarTransferAmount: ({ amount, recipient, token, walletAccount }: TransferAmountParams, client: DynamicClient) => Promise<{
+    transactionHash: string;
+}>;
+//# sourceMappingURL=stellarTransferAmount.d.ts.map

package/dist/utils/stellarTransferAmount/stellarTransferAmount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stellarTransferAmount.d.ts","sourceRoot":"","sources":["../../../src/utils/stellarTransferAmount/stellarTransferAmount.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,+BAA+B,CAAC;AAYvC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,gDACa,oBAAoB,UACzD,aAAa,KACpB,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CA2ErC,CAAC"}

package/package.json

@@ -1 +1,40 @@
-{ "name": "@dynamic-labs-sdk/stellar", "version": "0.0.0" }
+{
+  "name": "@dynamic-labs-sdk/stellar",
+  "version": "1.16.1",
+  "type": "module",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/exports/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/exports/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "default": "./dist/index.cjs.js"
+    }
+  },
+  "dependencies": {
+    "@stellar/stellar-sdk": "14.4.3",
+    "@stellar/freighter-api": "6.0.1",
+    "@lobstrco/signer-extension-api": "2.0.0",
+    "@dynamic-labs/sdk-api-core": "0.0.1058",
+    "@dynamic-labs-sdk/client": "1.16.1",
+    "@dynamic-labs-sdk/assert-package-version": "1.16.1"
+  },
+  "devDependencies": {
+    "eventemitter3": "5.0.1",
+    "vitest": "4.1.6"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsdown && pnpm exec tsc --emitDeclarationOnly -p ./tsconfig.lib.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test-with-coverage": "vitest run --coverage",
+    "check-versions": "pnpm --filter @tools/sync-package-versions run sync --check-only --package-filter stellar"
+  }
+}