@venlyfinance/react 0.2.0 → 0.4.0

package/AGENTS.md

@@ -17,6 +17,17 @@ You are building a financial product UI on `@venlyfinance/react`. These rules ex
 - Amounts: tabular figures, currency code after the amount, and never render a debit in red as the only signal. Empty numeric cells are an em dash, not 0.
 - Terminal failure states show the reason from the record; the status field is the explanation field.
 
+## Bring your own auth
+
+The Venly APIs authenticate machines (OAuth2 client credentials), not people: there is no end-user login, sign-up, session, password, or MFA endpoint in either API, by design. **The Venly APIs never see end-user credentials.** End-user auth is your identity layer's job; the sanctioned browser shape is a backend proxy that inherits YOUR app's session (`proxyClientOptions()`), never Venly's.
+
+The UI kit's auth and team blocks therefore render against two adapter interfaces, `AuthAdapter` and `TeamAdapter`, instead of an SDK client:
+
+- **Real implementations** wrap what you already run: OAuth/OIDC, Better Auth, Auth0, Clerk, Keycloak, or a plain session cookie. Implement `signIn`/`verifyTotp`/`signUp`/`session`/`signOut` (and the team CRUD) over your provider's SDK.
+- **Session-expiry contract:** `session()` returns `null` once the session has expired for any reason. The shell treats null as signed-out and redirects to sign-in; no other expiry signal exists in the interface.
+- **Mock adapters ship with the blocks** (`createMockAuthAdapter`, `createMockTeamAdapter`): zero credentials, deterministic 2FA code `000000`, an `expireSession()` driver, and invites that mint a display-only link – the mock never claims an email was sent.
+- Password reset, SSO buttons, and passkeys are provider features: point users at your provider's flow rather than rebuilding it behind the adapter.
+
 ## Demo choreography (mock mode)
 
 `useVenlyMock()` exposes the store controls. A credible end-to-end demo:

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,13 +38,13 @@ 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) |
 | `useRampLifecycle` | One ramp request, polled until terminal, with a status descriptor answering: must I act, who is it waiting on, what still works |
 | `venlyKeys` / `venlyQueries` | Query-key factory and pure `{queryKey, queryFn}` factories for prefetching, route loaders, and tests |
-| `useVenlyMock` | The mock controls (call log, `failNext`, `advanceVerification`, `advanceTransfer`) – defined only in mock mode |
+| `useVenlyMock` | The mock controls (call log, `failNext`, `respondNext`, `delayNext`, `advanceVerification`, `advanceTransfer`) – defined only in mock mode |
 | `proxyClientOptions` | Browser-safe production wiring (below) |
 
 ## The flow machines

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 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";
 export { describeRampStatus, useRampLifecycle, type RampLifecycleOptions, type RampStatus, type RampStatusDescriptor, } from "./flows/ramp-lifecycle.js";
 export { proxyClientOptions, VENLY_PROXY_SECRET_SENTINEL, type ProxyClientOptions, } from "./proxy.js";
 export { FundflowClient, VenlyApiError, VenlyAuthError, VenlyFinanceClient, } from "@venlyfinance/sdk";
-export type { Account, Party, RampRequest, Transfer, VirtualBankAccount, Wallet, } from "@venlyfinance/sdk";
+export type { Account, Party, RampRequest, Transfer, VirtualBankAccount, WalletBalance, Payout, PayoutRoute, PayoutBankAccount, } from "@venlyfinance/sdk";

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/mutations.d.ts

@@ -5,40 +5,42 @@ type CreatePaymentSessionBody = Parameters<VenlyFinanceClient["paymentSessions"]
 export declare function useCreateParty(): import("@tanstack/react-query").UseMutationResult<{
     id?: string;
     externalId?: string;
-    partyType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyType"];
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyStatus"];
+    partyType?: "INDIVIDUAL" | "ORGANISATION";
+    status?: "ACTIVE" | "SUSPENDED" | "BLOCKED";
+    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AddressDto"];
     firstName?: string;
     lastName?: string;
-    kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
+    kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "REJECTED";
     name?: string;
     vatNumber?: string;
-    kybStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KybStatus"];
-    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Address"];
+    kybStatus?: "PENDING" | "VERIFIED" | "DENIED";
     createdAt?: string;
     updatedAt?: string;
     version?: number;
 }, Error, {
-    partyType: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyType"];
+    partyType: "INDIVIDUAL" | "ORGANISATION";
     externalId?: string;
     firstName?: string;
     lastName?: string;
     name?: string;
     vatNumber?: string;
-    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Address"];
+    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AddressDto"];
+    sumsubToken?: string;
 }, unknown>;
 export declare function useCreateAccount(): import("@tanstack/react-query").UseMutationResult<{
     id?: string;
     externalId?: string;
     name?: string;
-    kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AccountStatus"];
+    kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "NOT_REQUIRED" | "REJECTED";
+    status?: "ACTIVE" | "SUSPENDED" | "CLOSED";
     createdAt?: string;
     version?: number;
 }, Error, {
     externalId: string;
     name?: string;
-    chain: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BlockchainNetwork"];
+    chain: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
     address?: string;
+    kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "NOT_REQUIRED" | "REJECTED";
     partyId?: string;
     party?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["CreatePartyRequest"];
     cardProviderReference?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["CardProviderReference"];
@@ -46,16 +48,19 @@ export declare function useCreateAccount(): import("@tanstack/react-query").UseM
 export declare function useCreateVirtualBankAccount(): import("@tanstack/react-query").UseMutationResult<{
     id?: string;
     accountId?: string;
-    bankAccountType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BankAccountType"];
+    bankAccountType?: "EUR_SEPA" | "USD_ACH";
     name?: string;
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["VirtualBankAccountStatus"];
-    currency?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatCurrency"];
-    targetCryptocurrency?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Cryptocurrency"];
+    status?: "PENDING" | "ACTIVE" | "CLOSED";
+    currency?: string;
+    targetCryptocurrency?: string;
     iban?: string;
     bic?: string;
+    accountNumber?: string;
+    routingNumber?: string;
     bankName?: string;
     beneficiaryName?: string;
     referenceCode?: string;
+    depositRails?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["ProviderDepositRail"][];
     createdAt?: string;
     updatedAt?: string;
 }, Error, {
@@ -65,14 +70,14 @@ export declare function useCreateVirtualBankAccount(): import("@tanstack/react-q
 export declare function useCreatePaymentSession(): import("@tanstack/react-query").UseMutationResult<{
     id?: string;
     accountId?: string;
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PaymentSessionStatus"];
+    status?: "CREATED" | "PENDING_PAYMENT" | "PAYMENT_RECEIVED" | "CONVERTING" | "MINTING" | "COMPLETED" | "FAILED" | "EXPIRED" | "CANCELLED" | "REFUNDING" | "REFUNDED";
     inAmount?: number;
     inCurrency?: string;
     outCryptocurrency?: string;
     paymentUrl?: string;
     externalRef?: string;
     walletId?: string;
-    blockchainTxId?: string | null;
+    blockchainTxId?: string;
     cancellable?: boolean;
     expiresAt?: string;
     metadata?: {

package/dist/queries.d.ts

@@ -4,15 +4,15 @@ 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<{
     id?: string;
     externalId?: string;
-    partyType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyType"];
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyStatus"];
+    partyType?: "INDIVIDUAL" | "ORGANISATION";
+    status?: "ACTIVE" | "SUSPENDED" | "BLOCKED";
+    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AddressDto"];
     firstName?: string;
     lastName?: string;
-    kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
+    kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "REJECTED";
     name?: string;
     vatNumber?: string;
-    kybStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KybStatus"];
-    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Address"];
+    kybStatus?: "PENDING" | "VERIFIED" | "DENIED";
     createdAt?: string;
     updatedAt?: string;
     version?: number;
@@ -21,15 +21,15 @@ type PartiesPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.parties>["q
 export declare function useParty(partyId: string | undefined, options?: Tune<Party>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
     id?: string;
     externalId?: string;
-    partyType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyType"];
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyStatus"];
+    partyType?: "INDIVIDUAL" | "ORGANISATION";
+    status?: "ACTIVE" | "SUSPENDED" | "BLOCKED";
+    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AddressDto"];
     firstName?: string;
     lastName?: string;
-    kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
+    kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "REJECTED";
     name?: string;
     vatNumber?: string;
-    kybStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KybStatus"];
-    address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Address"];
+    kybStatus?: "PENDING" | "VERIFIED" | "DENIED";
     createdAt?: string;
     updatedAt?: string;
     version?: number;
@@ -39,8 +39,8 @@ export declare function useAccounts(query?: AccountsQuery, options?: Tune<Accoun
     id?: string;
     externalId?: string;
     name?: string;
-    kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AccountStatus"];
+    kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "NOT_REQUIRED" | "REJECTED";
+    status?: "ACTIVE" | "SUSPENDED" | "CLOSED";
     createdAt?: string;
     version?: number;
 }>>, Error>;
@@ -49,34 +49,57 @@ export declare function useAccount(accountId: string | undefined, options?: Tune
     id?: string;
     externalId?: string;
     name?: string;
-    kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AccountStatus"];
+    kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "NOT_REQUIRED" | "REJECTED";
+    status?: "ACTIVE" | "SUSPENDED" | "CLOSED";
     createdAt?: string;
     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<{
-    id?: string;
-    chain?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BlockchainNetwork"];
-    type?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["WalletType"];
-    address?: string;
-    balances?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["TokenBalance"][];
-    amlStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AmlStatus"];
+    asset?: string;
+    contractAddress?: string;
+    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;
-    bankAccountType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BankAccountType"];
+    bankAccountType?: "EUR_SEPA" | "USD_ACH";
     name?: string;
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["VirtualBankAccountStatus"];
-    currency?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatCurrency"];
-    targetCryptocurrency?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Cryptocurrency"];
+    status?: "PENDING" | "ACTIVE" | "CLOSED";
+    currency?: string;
+    targetCryptocurrency?: string;
     iban?: string;
     bic?: string;
+    accountNumber?: string;
+    routingNumber?: string;
     bankName?: string;
     beneficiaryName?: string;
     referenceCode?: string;
+    depositRails?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["ProviderDepositRail"][];
     createdAt?: string;
     updatedAt?: string;
 }>>, Error>;
@@ -85,14 +108,14 @@ export declare function useTransfers(accountId: string | undefined, query?: Tran
     id?: string;
     senderAccountId?: string;
     receiverAccountId?: string;
-    chain?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BlockchainNetwork"];
+    chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
     asset?: string;
     amount?: number;
-    fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOrigin"];
+    fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOriginDto"];
     description?: string;
     merchantReference?: string;
     idempotencyKey?: string;
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["TransferStatus"];
+    status?: "PENDING" | "COMPLETED" | "FAILED";
     transactionHash?: string;
     errorMessage?: string;
     createdAt?: string;
@@ -103,14 +126,14 @@ export declare function useTransfer(accountId: string | undefined, transferId: s
     id?: string;
     senderAccountId?: string;
     receiverAccountId?: string;
-    chain?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BlockchainNetwork"];
+    chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
     asset?: string;
     amount?: number;
-    fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOrigin"];
+    fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOriginDto"];
     description?: string;
     merchantReference?: string;
     idempotencyKey?: string;
-    status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["TransferStatus"];
+    status?: "PENDING" | "COMPLETED" | "FAILED";
     transactionHash?: string;
     errorMessage?: string;
     createdAt?: 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

@@ -21,15 +21,15 @@ export declare const venlyQueries: {
         queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
             id?: string;
             externalId?: string;
-            partyType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyType"];
-            status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyStatus"];
+            partyType?: "INDIVIDUAL" | "ORGANISATION";
+            status?: "ACTIVE" | "SUSPENDED" | "BLOCKED";
+            address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AddressDto"];
             firstName?: string;
             lastName?: string;
-            kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
+            kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "REJECTED";
             name?: string;
             vatNumber?: string;
-            kybStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KybStatus"];
-            address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Address"];
+            kybStatus?: "PENDING" | "VERIFIED" | "DENIED";
             createdAt?: string;
             updatedAt?: string;
             version?: number;
@@ -40,15 +40,15 @@ export declare const venlyQueries: {
         queryFn: () => Promise<{
             id?: string;
             externalId?: string;
-            partyType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyType"];
-            status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["PartyStatus"];
+            partyType?: "INDIVIDUAL" | "ORGANISATION";
+            status?: "ACTIVE" | "SUSPENDED" | "BLOCKED";
+            address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AddressDto"];
             firstName?: string;
             lastName?: string;
-            kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
+            kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "REJECTED";
             name?: string;
             vatNumber?: string;
-            kybStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KybStatus"];
-            address?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Address"];
+            kybStatus?: "PENDING" | "VERIFIED" | "DENIED";
             createdAt?: string;
             updatedAt?: string;
             version?: number;
@@ -60,8 +60,8 @@ export declare const venlyQueries: {
             id?: string;
             externalId?: string;
             name?: string;
-            kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
-            status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AccountStatus"];
+            kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "NOT_REQUIRED" | "REJECTED";
+            status?: "ACTIVE" | "SUSPENDED" | "CLOSED";
             createdAt?: string;
             version?: number;
         }>>;
@@ -72,8 +72,8 @@ export declare const venlyQueries: {
             id?: string;
             externalId?: string;
             name?: string;
-            kycStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["KycStatus"];
-            status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AccountStatus"];
+            kycStatus?: "VERIFICATION_PENDING" | "VERIFIED" | "NOT_REQUIRED" | "REJECTED";
+            status?: "ACTIVE" | "SUSPENDED" | "CLOSED";
             createdAt?: string;
             version?: number;
         }>;
@@ -81,12 +81,30 @@ export declare const venlyQueries: {
     readonly wallets: (clients: VenlyClients, accountId: string, query?: WalletsQuery) => {
         queryKey: readonly ["venly", "account", string, "wallets", {} | null];
         queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
-            id?: string;
-            chain?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BlockchainNetwork"];
-            type?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["WalletType"];
-            address?: string;
-            balances?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["TokenBalance"][];
-            amlStatus?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["AmlStatus"];
+            asset?: string;
+            contractAddress?: string;
+            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) => {
@@ -94,16 +112,19 @@ export declare const venlyQueries: {
         queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
             id?: string;
             accountId?: string;
-            bankAccountType?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BankAccountType"];
+            bankAccountType?: "EUR_SEPA" | "USD_ACH";
             name?: string;
-            status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["VirtualBankAccountStatus"];
-            currency?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatCurrency"];
-            targetCryptocurrency?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["Cryptocurrency"];
+            status?: "PENDING" | "ACTIVE" | "CLOSED";
+            currency?: string;
+            targetCryptocurrency?: string;
             iban?: string;
             bic?: string;
+            accountNumber?: string;
+            routingNumber?: string;
             bankName?: string;
             beneficiaryName?: string;
             referenceCode?: string;
+            depositRails?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["ProviderDepositRail"][];
             createdAt?: string;
             updatedAt?: string;
         }>>;
@@ -114,14 +135,14 @@ export declare const venlyQueries: {
             id?: string;
             senderAccountId?: string;
             receiverAccountId?: string;
-            chain?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BlockchainNetwork"];
+            chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
             asset?: string;
             amount?: number;
-            fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOrigin"];
+            fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOriginDto"];
             description?: string;
             merchantReference?: string;
             idempotencyKey?: string;
-            status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["TransferStatus"];
+            status?: "PENDING" | "COMPLETED" | "FAILED";
             transactionHash?: string;
             errorMessage?: string;
             createdAt?: string;
@@ -134,14 +155,14 @@ export declare const venlyQueries: {
             id?: string;
             senderAccountId?: string;
             receiverAccountId?: string;
-            chain?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["BlockchainNetwork"];
+            chain?: "AVALANCHE" | "BASE" | "ETHEREUM" | "POLYGON" | "SOLANA";
             asset?: string;
             amount?: number;
-            fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOrigin"];
+            fiatOrigin?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["FiatOriginDto"];
             description?: string;
             merchantReference?: string;
             idempotencyKey?: string;
-            status?: import("@venlyfinance/sdk").FinanceComponents["schemas"]["TransferStatus"];
+            status?: "PENDING" | "COMPLETED" | "FAILED";
             transactionHash?: string;
             errorMessage?: string;
             createdAt?: string;

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.2.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.3.0"
+    "@venlyfinance/sdk": "^0.5.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",