@venlyfinance/react 0.3.0 → 0.5.0

package/AGENTS.md

@@ -9,6 +9,7 @@ You are building a financial product UI on `@venlyfinance/react`. These rules ex
 3. **Never place `clientSecret` in browser code.** The provider throws if you try. For browser apps use `proxyClientOptions()` against your own backend route.
 4. **Money movement is stage-then-confirm.** Render a review step showing `state.staged` (the exact request) before calling `confirm()`. Never wire a form submit directly to execution.
 5. **Approval UIs render the rule, not the error.** Use `capability` from `useFourEyesApproval`: when `reason` is `"actor-is-creator"`, say that a second person must approve – do not show buttons that will be refused. On failure `"stale-version"`, refetch and let the operator re-decide; never auto-retry an approval.
+6. **Gate both the screen and its runtime contract, and wire both into CI.** Run `npx @venlyfinance/settlement-mcp review "src/**/*.tsx"` for the design contract and `npx @venlyfinance/settlement-mcp verify "src/**/*.{ts,tsx}"` for package/provider/hook/proxy composition. Each fails (exit 1) on any error-severity finding. A deliberate, justified exception carries `venly-allow:<rule-id>` on the offending line or the line above.
 
 ## Rendering money states
 
@@ -31,4 +32,4 @@ The UI kit's auth and team blocks therefore render against two adapter interface
 ## Demo choreography (mock mode)
 
 `useVenlyMock()` exposes the store controls. A credible end-to-end demo:
-create party → `advanceVerification(id)` → create account → virtual bank account (note its `referenceCode`) → stage + confirm a transfer → `advanceTransfer(id)` → show the ledger. Inject failures with `failNext("CONFLICT")` to show the stale-version approval path – error states are part of the product.
+create party → `advanceVerification(id)` → create account → virtual bank account (note its `referenceCode`) → **fund it: `simulations.inbound.credit(vbaId, 500)`** (a new account holds nothing, as in production; an unfunded transfer is refused with `402 insufficient-funds`) → stage + confirm a transfer → `advanceTransfer(id)` → show the ledger, and `simulations.ledger.verify()` to prove it balances. Inject failures with `failNext("CONFLICT")` to show the stale-version approval path – error states are part of the product.

package/CHANGELOG.md

@@ -14,3 +14,37 @@ Initial release.
 ## 0.1.1
 
 - Fix: `useStagedTransfer` stuck in "submitting" under React StrictMode – the hook cleanup's `dispose()` left the controller permanently dead for the remount, so `confirm()`'s continuation dropped its state updates. A new subscription now revives the controller. Found by driving the flow in a real browser; regression test added.
+
+## 0.2.0 – 2026-08-07
+
+*(Entry backfilled 2026-08-15 – this release shipped without a changelog note.)*
+
+- Read hooks for the fundflow company surface: `useCompanyBankAccounts`,
+  `useCompanyBankAccount`, `useCompanyWallets`, `useBankAccountConfig`,
+  `useDepositWallets`, `useRampPairs`, `useCompanyFees`.
+- Write hooks with cache invalidation: `useCreateCompanyBankAccount`,
+  `useCreateCompanyWallet`, `useSetRampAmount`, `useInitiateRamp`.
+- Matching `venlyKeys` / `venlyQueries` factories for every new read.
+
+## 0.3.0 – 2026-08-14
+
+*(Entry backfilled 2026-08-15 – this release shipped without a changelog note.)*
+
+- **BREAKING (inherited from `@venlyfinance/sdk` 0.4.0 / contract 1.3.0):**
+  the `Wallet` type no longer exists – `wallets.list` returns per-asset
+  `WalletBalance` rows and this package re-exports `WalletBalance` instead.
+  Monetary amounts are JSON numbers.
+- Re-exports the payout types (`Payout`, `PayoutRoute`, `PayoutBankAccount`)
+  shipped by sdk 0.4.0.
+- Requires `@venlyfinance/sdk` ^0.4.0.
+
+## 0.4.0 – 2026-08-15
+
+- New read hooks: `useSupportedAssets()` (tenant-wide assets, each with its
+  on-chain `decimals` – the render contract for amounts; cached hard) and
+  `useAccountSupportedAssets(accountId)` (adds per-asset `permitStatus`,
+  not frozen because status moves while an asset activates).
+- `venlyKeys.supportedAssets()` / `venlyKeys.accountSupportedAssets(id)` and
+  matching `venlyQueries` factories; the account-scoped key shares the
+  `["venly", "account", id]` prefix so account invalidations reach it.
+- Requires `@venlyfinance/sdk` ^0.5.0 (the `supportedAssets` resource).

package/README.md

@@ -6,6 +6,8 @@ Headless React layer for the [Venly Finance and Fundflow APIs](https://github.co
 
 No components, no CSS. This package owns data and state; your UI (or the one your coding agent assembles) owns the pixels. The full behaviour is covered by a node:test suite that runs with zero network.
 
+Building with a coding agent? Start from [AGENTS.md](AGENTS.md).
+
 ## Try it in 0 minutes (mock mode)
 
 ```bash
@@ -36,7 +38,7 @@ Mock mode needs zero credentials and makes zero network calls: every hook answer
 | Export | What it does |
 |---|---|
 | `<VenlyProvider>` | Constructs the Finance + Fundflow clients for `mock`, `staging`, or `production`; brings its own QueryClient if the app has none |
-| `useParties` `useAccounts` `useWallets` `useVirtualBankAccounts` `useTransfers` `useRampRequests` `useReferenceData` `useFeeQuote` … | Read hooks, one per API resource, cache keys managed for you |
+| `useParties` `useAccounts` `useWallets` `useSupportedAssets` `useAccountSupportedAssets` `useVirtualBankAccounts` `useTransfers` `useRampRequests` `useReferenceData` `useFeeQuote` … | Read hooks, one per API resource, cache keys managed for you |
 | `useCreateParty` `useCreateAccount` `useCreateVirtualBankAccount` `useCreatePaymentSession` `useCreateRampRequest` | Write hooks with cache invalidation wired |
 | `useStagedTransfer` | Stage-then-confirm machine: validate → freeze the exact request with a pinned idempotency key → execute once → poll to terminal |
 | `useFourEyesApproval` | Approve/reject/cancel with the optimistic-locking `version` carried through; 409 surfaces as `"stale-version"` (refetch and re-decide, never auto-retry) |

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { VenlyProvider, useVenly, useVenlyMock, type VenlyClients, type VenlyProviderProps, type VenlyReactEnvironment, } from "./provider.js";
 export { venlyKeys } from "./keys.js";
 export { venlyQueries, type AccountsQuery, type FeeQuoteInput, type PartiesQuery, type RampRequestsQuery, type TransfersQuery, type VirtualBankAccountsQuery, type WalletsQuery, } from "./query-options.js";
-export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useVirtualBankAccounts, useWallets, useCompanyBankAccount, useCompanyBankAccounts, useCompanyWallets, useBankAccountConfig, useDepositWallets, useRampPairs, } from "./queries.js";
+export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useTransfersForPeriod, collectTransfersForPeriod, type TransferPeriod, type TransfersForPeriodPage, useVirtualBankAccounts, useWallets, useCompanyBankAccount, useCompanyBankAccounts, useCompanyWallets, useBankAccountConfig, useDepositWallets, useRampPairs, useSupportedAssets, useAccountSupportedAssets, } from "./queries.js";
 export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, useCreateCompanyBankAccount, useCreateCompanyWallet, useSetRampAmount, useInitiateRamp, } from "./mutations.js";
 export { StagedTransferController, useStagedTransfer, validateDraft, type StagedRequest, type StagedTransferOptions, type StagedTransferState, type TransferDraft, } from "./flows/staged-transfer.js";
 export { approvalCapabilities, interpretApprovalError, useFourEyesApproval, type ApprovalCapability, type ApprovalFailureKind, type FourEyesState, } from "./flows/four-eyes.js";

package/dist/index.js

@@ -4,7 +4,7 @@ export { VenlyProvider, useVenly, useVenlyMock, } from "./provider.js";
 export { venlyKeys } from "./keys.js";
 export { venlyQueries, } from "./query-options.js";
 // Read hooks
-export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useVirtualBankAccounts, useWallets, useCompanyBankAccount, useCompanyBankAccounts, useCompanyWallets, useBankAccountConfig, useDepositWallets, useRampPairs, } from "./queries.js";
+export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useTransfersForPeriod, collectTransfersForPeriod, useVirtualBankAccounts, useWallets, useCompanyBankAccount, useCompanyBankAccounts, useCompanyWallets, useBankAccountConfig, useDepositWallets, useRampPairs, useSupportedAssets, useAccountSupportedAssets, } from "./queries.js";
 // Write hooks
 export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, useCreateCompanyBankAccount, useCreateCompanyWallet, useSetRampAmount, useInitiateRamp, } from "./mutations.js";
 // Flow machines: the regulated-money lifecycles

package/dist/keys.d.ts

@@ -9,8 +9,14 @@ export declare const venlyKeys: {
     readonly accounts: (query?: unknown) => readonly ["venly", "accounts", {} | null];
     readonly account: (accountId: string) => readonly ["venly", "account", string];
     readonly wallets: (accountId: string, query?: unknown) => readonly ["venly", "account", string, "wallets", {} | null];
+    readonly supportedAssets: () => readonly ["venly", "supported-assets"];
+    readonly accountSupportedAssets: (accountId: string) => readonly ["venly", "account", string, "supported-assets"];
     readonly virtualBankAccounts: (accountId: string, query?: unknown) => readonly ["venly", "account", string, "virtual-bank-accounts", {} | null];
     readonly transfers: (accountId: string, query?: unknown) => readonly ["venly", "account", string, "transfers", {} | null];
+    readonly transfersForPeriod: (accountId: string, period: {
+        start: string;
+        end: string;
+    }) => readonly ["venly", "account", string, "transfers-for-period", string, string];
     readonly transfer: (accountId: string, transferId: string) => readonly ["venly", "account", string, "transfer", string];
     readonly rampRequests: (query?: unknown) => readonly ["venly", "ramp-requests", {} | null];
     readonly rampRequest: (id: string) => readonly ["venly", "ramp-request", string];

package/dist/keys.js

@@ -9,8 +9,11 @@ export const venlyKeys = {
     accounts: (query) => ["venly", "accounts", query ?? null],
     account: (accountId) => ["venly", "account", accountId],
     wallets: (accountId, query) => ["venly", "account", accountId, "wallets", query ?? null],
+    supportedAssets: () => ["venly", "supported-assets"],
+    accountSupportedAssets: (accountId) => ["venly", "account", accountId, "supported-assets"],
     virtualBankAccounts: (accountId, query) => ["venly", "account", accountId, "virtual-bank-accounts", query ?? null],
     transfers: (accountId, query) => ["venly", "account", accountId, "transfers", query ?? null],
+    transfersForPeriod: (accountId, period) => ["venly", "account", accountId, "transfers-for-period", period.start, period.end],
     transfer: (accountId, transferId) => ["venly", "account", accountId, "transfer", transferId],
     rampRequests: (query) => ["venly", "ramp-requests", query ?? null],
     rampRequest: (id) => ["venly", "ramp-request", id],

package/dist/queries.d.ts

@@ -1,7 +1,8 @@
 import { type UseQueryOptions } from "@tanstack/react-query";
+import { type Page, type Transfer as TransferRow } from "@venlyfinance/sdk";
 import { venlyQueries, type AccountsQuery, type FeeQuoteInput, type PartiesQuery, type RampRequestsQuery, type TransfersQuery, type VirtualBankAccountsQuery, type WalletsQuery, type CompanyBankAccountsQuery, type CompanyWalletsQuery, type DepositWalletsQuery } from "./query-options.js";
 type Tune<T> = Omit<UseQueryOptions<T, Error>, "queryKey" | "queryFn">;
-export declare function useParties(query?: PartiesQuery, options?: Tune<PartiesPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+export declare function useParties(query?: PartiesQuery, options?: Tune<PartiesPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     id?: string;
     externalId?: string;
     partyType?: "INDIVIDUAL" | "ORGANISATION";
@@ -35,7 +36,7 @@ export declare function useParty(partyId: string | undefined, options?: Tune<Par
     version?: number;
 }>, Error>;
 type Party = Awaited<ReturnType<ReturnType<typeof venlyQueries.party>["queryFn"]>>;
-export declare function useAccounts(query?: AccountsQuery, options?: Tune<AccountsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+export declare function useAccounts(query?: AccountsQuery, options?: Tune<AccountsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     id?: string;
     externalId?: string;
     name?: string;
@@ -55,13 +56,36 @@ export declare function useAccount(accountId: string | undefined, options?: Tune
     version?: number;
 }>, Error>;
 type Account = Awaited<ReturnType<ReturnType<typeof venlyQueries.account>["queryFn"]>>;
-export declare function useWallets(accountId: string | undefined, query?: WalletsQuery, options?: Tune<WalletsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+export declare function useWallets(accountId: string | undefined, query?: WalletsQuery, options?: Tune<WalletsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     asset?: string;
     contractAddress?: string;
     amount?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["CryptoBalanceSummaryDto"];
 }>>, Error>;
 type WalletsPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.wallets>["queryFn"]>>;
-export declare function useVirtualBankAccounts(accountId: string | undefined, query?: VirtualBankAccountsQuery, options?: Tune<VibaPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+/**
+ * Tenant-wide supported assets. `decimals` per asset is the render contract
+ * for amounts; cached hard (the asset set changes on deploys, not minutes).
+ */
+export declare function useSupportedAssets(options?: Tune<SupportedAssetsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
+    chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
+    cryptoCurrency?: string;
+    decimals?: number;
+    contractAddress?: string;
+}>>, Error>;
+type SupportedAssetsPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.supportedAssets>["queryFn"]>>;
+/**
+ * Account-scoped supported assets (adds `permitStatus`). Not frozen:
+ * permit status moves while an asset activates.
+ */
+export declare function useAccountSupportedAssets(accountId: string | undefined, options?: Tune<AccountSupportedAssetsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
+    chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
+    cryptoCurrency?: string;
+    decimals?: number;
+    contractAddress?: string;
+    permitStatus?: "READY" | "ACTIVATING" | "ACTION_REQUIRED" | "PENDING" | "FAILED" | "NO_WALLET";
+}>>, Error>;
+type AccountSupportedAssetsPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.accountSupportedAssets>["queryFn"]>>;
+export declare function useVirtualBankAccounts(accountId: string | undefined, query?: VirtualBankAccountsQuery, options?: Tune<VibaPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     id?: string;
     accountId?: string;
     bankAccountType?: "EUR_SEPA" | "USD_ACH";
@@ -81,7 +105,7 @@ export declare function useVirtualBankAccounts(accountId: string | undefined, qu
     updatedAt?: string;
 }>>, Error>;
 type VibaPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.virtualBankAccounts>["queryFn"]>>;
-export declare function useTransfers(accountId: string | undefined, query?: TransfersQuery, options?: Tune<TransfersPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+export declare function useTransfers(accountId: string | undefined, query?: TransfersQuery, options?: Tune<TransfersPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     id?: string;
     senderAccountId?: string;
     receiverAccountId?: string;
@@ -99,6 +123,27 @@ export declare function useTransfers(accountId: string | undefined, query?: Tran
     updatedAt?: string;
 }>>, Error>;
 type TransfersPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.transfers>["queryFn"]>>;
+export type TransferPeriod = {
+    start: string;
+    end: string;
+};
+export type TransfersForPeriodPage = {
+    /** Rows whose `createdAt` falls in `[start, end]`. */
+    items: TransferRow[];
+    /**
+     * Every transfer on the account after paging to completion. Opening and
+     * closing walk from the current wallet total through this full ledger;
+     * a window-only set would silently drop later movements.
+     */
+    ledger: TransferRow[];
+    resultPresent: boolean;
+};
+/**
+ * Page every transfer on the account (the list contract has no date filter),
+ * then keep the window. `iteratePages` walks `hasNextPage`.
+ */
+export declare function collectTransfersForPeriod(list: (query?: TransfersQuery) => Promise<Page<Transfer>>, period: TransferPeriod, pageSize?: number): Promise<TransfersForPeriodPage>;
+export declare function useTransfersForPeriod(accountId: string | undefined, period: TransferPeriod | undefined, options?: Tune<TransfersForPeriodPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<TransfersForPeriodPage>, Error>;
 export declare function useTransfer(accountId: string | undefined, transferId: string | undefined, options?: Tune<Transfer>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
     id?: string;
     senderAccountId?: string;
@@ -117,7 +162,7 @@ export declare function useTransfer(accountId: string | undefined, transferId: s
     updatedAt?: string;
 }>, Error>;
 type Transfer = Awaited<ReturnType<ReturnType<typeof venlyQueries.transfer>["queryFn"]>>;
-export declare function useRampRequests(query?: RampRequestsQuery, options?: Tune<RampPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+export declare function useRampRequests(query?: RampRequestsQuery, options?: Tune<RampPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     id?: string;
     paymentReference?: string;
     rampType?: "ON_RAMP" | "OFF_RAMP";
@@ -197,7 +242,7 @@ export declare function useFeeQuote(input: FeeQuoteInput | undefined, options?:
     percentage?: number;
 }>, Error>;
 type FeeQuote = Awaited<ReturnType<ReturnType<typeof venlyQueries.feeQuote>["queryFn"]>>;
-export declare function useCompanyBankAccounts(query?: CompanyBankAccountsQuery, options?: Tune<BankAccountsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+export declare function useCompanyBankAccounts(query?: CompanyBankAccountsQuery, options?: Tune<BankAccountsPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     id?: string;
     name?: string;
     bankName?: string;
@@ -245,7 +290,7 @@ export declare function useCompanyBankAccount(id: string | undefined, options?:
     currency?: string;
 }>, Error>;
 type BankAccountDetail = Awaited<ReturnType<ReturnType<typeof venlyQueries.companyBankAccount>["queryFn"]>>;
-export declare function useCompanyWallets(query?: CompanyWalletsQuery, options?: Tune<WalletsListPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<import("@venlyfinance/sdk").Page<{
+export declare function useCompanyWallets(query?: CompanyWalletsQuery, options?: Tune<WalletsListPage>): import("@tanstack/react-query").UseQueryResult<NoInfer<Page<{
     id?: string;
     description?: string;
     address?: string;

package/dist/queries.js

@@ -1,6 +1,8 @@
 import { useQuery } from "@tanstack/react-query";
+import { iteratePages } from "@venlyfinance/sdk";
 import { useVenly } from "./provider.js";
 import { venlyQueries, } from "./query-options.js";
+import { venlyKeys } from "./keys.js";
 export function useParties(query, options) {
     const clients = useVenly();
     return useQuery({ ...venlyQueries.parties(clients, query), ...options });
@@ -33,6 +35,30 @@ export function useWallets(accountId, query, options) {
         ...options,
     });
 }
+/**
+ * Tenant-wide supported assets. `decimals` per asset is the render contract
+ * for amounts; cached hard (the asset set changes on deploys, not minutes).
+ */
+export function useSupportedAssets(options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.supportedAssets(clients),
+        staleTime: Infinity,
+        ...options,
+    });
+}
+/**
+ * Account-scoped supported assets (adds `permitStatus`). Not frozen:
+ * permit status moves while an asset activates.
+ */
+export function useAccountSupportedAssets(accountId, options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.accountSupportedAssets(clients, accountId ?? ""),
+        enabled: Boolean(accountId) && (options?.enabled ?? true),
+        ...options,
+    });
+}
 export function useVirtualBankAccounts(accountId, query, options) {
     const clients = useVenly();
     return useQuery({
@@ -49,6 +75,34 @@ export function useTransfers(accountId, query, options) {
         ...options,
     });
 }
+/**
+ * Page every transfer on the account (the list contract has no date filter),
+ * then keep the window. `iteratePages` walks `hasNextPage`.
+ */
+export async function collectTransfersForPeriod(list, period, pageSize = 20) {
+    const ledger = [];
+    for await (const item of iteratePages((params) => list({ page: params.page, size: params.size }), {
+        size: pageSize,
+    })) {
+        ledger.push(item);
+    }
+    const items = ledger.filter((transfer) => {
+        const at = transfer.createdAt;
+        return Boolean(at && at >= period.start && at <= period.end);
+    });
+    return { items, ledger, resultPresent: true };
+}
+export function useTransfersForPeriod(accountId, period, options) {
+    const clients = useVenly();
+    const start = period?.start ?? "";
+    const end = period?.end ?? "";
+    return useQuery({
+        queryKey: venlyKeys.transfersForPeriod(accountId ?? "", { start, end }),
+        queryFn: () => collectTransfersForPeriod((query) => clients.finance.transfers.list(accountId ?? "", query), { start, end }),
+        enabled: Boolean(accountId && start && end) && (options?.enabled ?? true),
+        ...options,
+    });
+}
 export function useTransfer(accountId, transferId, options) {
     const clients = useVenly();
     return useQuery({

package/dist/query-options.d.ts

@@ -86,6 +86,27 @@ export declare const venlyQueries: {
             amount?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["CryptoBalanceSummaryDto"];
         }>>;
     };
+    /** Tenant-wide supported assets, each with its on-chain `decimals`. */
+    readonly supportedAssets: (clients: VenlyClients) => {
+        queryKey: readonly ["venly", "supported-assets"];
+        queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
+            chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
+            cryptoCurrency?: string;
+            decimals?: number;
+            contractAddress?: string;
+        }>>;
+    };
+    /** Account-scoped rows: the same assets plus per-asset `permitStatus`. */
+    readonly accountSupportedAssets: (clients: VenlyClients, accountId: string) => {
+        queryKey: readonly ["venly", "account", string, "supported-assets"];
+        queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
+            chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
+            cryptoCurrency?: string;
+            decimals?: number;
+            contractAddress?: string;
+            permitStatus?: "READY" | "ACTIVATING" | "ACTION_REQUIRED" | "PENDING" | "FAILED" | "NO_WALLET";
+        }>>;
+    };
     readonly virtualBankAccounts: (clients: VenlyClients, accountId: string, query?: VirtualBankAccountsQuery) => {
         queryKey: readonly ["venly", "account", string, "virtual-bank-accounts", {} | null];
         queryFn: () => Promise<import("@venlyfinance/sdk").Page<{

package/dist/query-options.js

@@ -25,6 +25,16 @@ export const venlyQueries = {
         queryKey: venlyKeys.wallets(accountId, query),
         queryFn: () => clients.finance.wallets.list(accountId, query),
     }),
+    /** Tenant-wide supported assets, each with its on-chain `decimals`. */
+    supportedAssets: (clients) => ({
+        queryKey: venlyKeys.supportedAssets(),
+        queryFn: () => clients.finance.supportedAssets.list(),
+    }),
+    /** Account-scoped rows: the same assets plus per-asset `permitStatus`. */
+    accountSupportedAssets: (clients, accountId) => ({
+        queryKey: venlyKeys.accountSupportedAssets(accountId),
+        queryFn: () => clients.finance.supportedAssets.listForAccount(accountId),
+    }),
     virtualBankAccounts: (clients, accountId, query) => ({
         queryKey: venlyKeys.virtualBankAccounts(accountId, query),
         queryFn: () => clients.finance.virtualBankAccounts.list(accountId, query),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venlyfinance/react",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Headless React layer for the Venly Finance and Fundflow APIs: provider, TanStack Query hooks, and flow state machines for regulated money movement. Runs with zero credentials in mock mode.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@venlyfinance/sdk": "^0.4.0"
+    "@venlyfinance/sdk": "^0.5.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
@@ -62,4 +62,4 @@
     "directory": "react"
   },
   "homepage": "https://github.com/Venly/venly-settlement-sdk/tree/main/react#readme"
-}
+}