TypeScript Integration

The reviewed application declares Next.js ^16.2.3, React 19.2.0, Stellar SDK ^14.4.3, and Freighter API ^6.0.1. These are repository declarations, not claims about latest upstream releases.

Run the application

From mercury-stellar-backend:

npm ci
npm run dev

Use its LOCAL_SETUP.md for environment-specific setup. Basic contract reads use the configured testnet RPC. Mercury history, Privy login, Copilot, and Hubble require their respective configuration. Keep service credentials server-side.

Service map

Module	Export
`lib/stellar-utils.ts`	`ContractService`, `WalletService`, `CONTRACT_ADDRESSES`, `ASSET_TYPES`
`lib/margin-utils.ts`	`MarginAccountService`
`lib/blend-utils.ts`	`BlendService`
`lib/soroswap-utils.ts`	`SoroswapService`
`lib/aquarius-utils.ts`	`AquariusService`
`lib/wallet-adapter.ts`	Wallet-kind-independent address, access, and signing functions
`lib/one-click-strategy.ts`	`executeOneClickStrategy`, `closePosition`

Imports using @/ assume the application’s TypeScript alias. There is no generated universal client behind these service methods; read their argument types before reusing them.

Encode exact amounts

For direct contract calls, use decimal strings or bigint, not floating-point multiplication by 10^18:

import { nativeToScVal } from '@stellar/stellar-sdk';

const oneTokenWad = 1_000_000_000_000_000_000n;
const amountArg = nativeToScVal(oneTokenWad, { type: 'u256' });
const symbolArg = nativeToScVal('XLM', { type: 'symbol' });

A token balance is native units. Pool deposit and manager repayment amounts are WAD. Pool redemption expects WAD receipt quantity. Controller minima and LP-removal units vary by protocol; see the controller references.

Checks

npm run lint, npm test, and npm run build are the application checks. Rust integrated tests depend on the imported prerequisite WASMs. Documentation updates do not establish that a deployment or full integration test passed.

Source reference

mercury-stellar-backend/package.json
mercury-stellar-backend/lib/stellar-utils.ts
mercury-stellar-backend/LOCAL_SETUP.md

Introduction

Contract Reference