Node.js SDK

The Node.js SDK is intended for backend services, workers, payout processors, webhook tooling, and other server-side integrations.

Package

Field	Value
Package	`@f-wallet/node`
Version	`0.1.0`
Repository	`f-wallet/fwallet-js`

npm install @f-wallet/node

Client setup

import { ApiKeyAuth, TransfersApi } from "@f-wallet/node";

const transfers = new TransfersApi("https://api.fwallet.co.ug");
transfers.setDefaultAuthentication(new ApiKeyAuth("header", "X-API-Key", "fwk_live_..."));

await transfers.transfersPostTransfers({
  idempotencyKey: "transfer_001",
  transfersPostTransfersRequest: {
    fromWalletId: "wallet-a",
    toWalletId: "wallet-b",
    amount: 100000,
    currencyCode: "UGX",
  },
});

Resource clients

Resource	Class
Admin	`AdminApi`
Auth	`AuthApi`
Deposits	`DepositsApi`
Developer	`DeveloperApi`
Health	`HealthApi`
Journal	`JournalApi`
Payouts	`PayoutsApi`
System	`SystemApi`
Team	`TeamApi`
Tenants	`TenantsApi`
Transfers	`TransfersApi`
Wallets	`WalletsApi`

Operation methods

The Node.js SDK uses the same generated operation names as the TypeScript SDK. See the TypeScript operation reference.

Signing

@f-wallet/node exports request signing helpers for HMAC signed server-to-server requests. Use this package for backend services such as Striker Market that keep FWALLET_STRIKER_KEY_ID and FWALLET_STRIKER_SIGNING_SECRET on the server and never expose signing secrets to the browser.