@venlyfinance/react 0.3.0 → 0.4.0

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, 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, 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,6 +9,8 @@ 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 transfer: (accountId: string, transferId: string) => readonly ["venly", "account", string, "transfer", string];

package/dist/keys.js

@@ -9,6 +9,8 @@ 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],
     transfer: (accountId, transferId) => ["venly", "account", accountId, "transfer", transferId],

package/dist/queries.d.ts

@@ -61,6 +61,29 @@ export declare function useWallets(accountId: string | undefined, query?: Wallet
     amount?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["CryptoBalanceSummaryDto"];
 }>>, Error>;
 type WalletsPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.wallets>["queryFn"]>>;
+/**
+ * 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<import("@venlyfinance/sdk").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<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";
+}>>, 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<import("@venlyfinance/sdk").Page<{
     id?: string;
     accountId?: string;

package/dist/queries.js

@@ -33,6 +33,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({

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.4.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"
-}
+}