@venlyfinance/react 0.1.1 → 0.3.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/README.md

@@ -42,7 +42,7 @@ Mock mode needs zero credentials and makes zero network calls: every hook answer
 | `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
@@ -126,4 +126,6 @@ npm test          # node:test, zero network
 npm run build
 ```
 
+See it assembled end to end: [`examples/mock-bank`](../examples/mock-bank/) runs a full account experience on these hooks in mock mode – `npm install && npm run dev`, fake data, zero credentials.
+
 MIT. Part of the [venly-settlement-sdk](https://github.com/Venly/venly-settlement-sdk) monorepo alongside `@venlyfinance/sdk` and `@venlyfinance/settlement-mcp`.

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, } from "./queries.js";
-export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, } from "./mutations.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 { 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,9 +4,9 @@ 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, } from "./queries.js";
+export { useAccount, useAccounts, useCompanyFees, useFeeQuote, useParties, useParty, useRampRequest, useRampRequests, useReferenceData, useTransfer, useTransfers, useVirtualBankAccounts, useWallets, useCompanyBankAccount, useCompanyBankAccounts, useCompanyWallets, useBankAccountConfig, useDepositWallets, useRampPairs, } from "./queries.js";
 // Write hooks
-export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, } from "./mutations.js";
+export { useCreateAccount, useCreateParty, useCreatePaymentSession, useCreateRampRequest, useCreateVirtualBankAccount, useCreateCompanyBankAccount, useCreateCompanyWallet, useSetRampAmount, useInitiateRamp, } from "./mutations.js";
 // Flow machines: the regulated-money lifecycles
 export { StagedTransferController, useStagedTransfer, validateDraft, } from "./flows/staged-transfer.js";
 export { approvalCapabilities, interpretApprovalError, useFourEyesApproval, } from "./flows/four-eyes.js";

package/dist/keys.d.ts

@@ -15,6 +15,12 @@ export declare const venlyKeys: {
     readonly rampRequests: (query?: unknown) => readonly ["venly", "ramp-requests", {} | null];
     readonly rampRequest: (id: string) => readonly ["venly", "ramp-request", string];
     readonly referenceData: () => readonly ["venly", "reference-data"];
+    readonly companyBankAccounts: (query?: unknown) => readonly ["venly", "company-bank-accounts", {} | null];
+    readonly companyBankAccount: (id: string) => readonly ["venly", "company-bank-account", string];
+    readonly companyWallets: (query?: unknown) => readonly ["venly", "company-wallets", {} | null];
+    readonly bankAccountConfig: () => readonly ["venly", "bank-account-config"];
+    readonly depositWallets: (query?: unknown) => readonly ["venly", "deposit-wallets", {} | null];
+    readonly rampPairs: (direction: "on" | "off") => readonly ["venly", "ramp-pairs", "on" | "off"];
     readonly companyFees: () => readonly ["venly", "company-fees"];
     readonly feeQuote: (input: unknown) => readonly ["venly", "fee-quote", unknown];
 };

package/dist/keys.js

@@ -15,6 +15,12 @@ export const venlyKeys = {
     rampRequests: (query) => ["venly", "ramp-requests", query ?? null],
     rampRequest: (id) => ["venly", "ramp-request", id],
     referenceData: () => ["venly", "reference-data"],
+    companyBankAccounts: (query) => ["venly", "company-bank-accounts", query ?? null],
+    companyBankAccount: (id) => ["venly", "company-bank-account", id],
+    companyWallets: (query) => ["venly", "company-wallets", query ?? null],
+    bankAccountConfig: () => ["venly", "bank-account-config"],
+    depositWallets: (query) => ["venly", "deposit-wallets", query ?? null],
+    rampPairs: (direction) => ["venly", "ramp-pairs", direction],
     companyFees: () => ["venly", "company-fees"],
     feeQuote: (input) => ["venly", "fee-quote", input],
 };

package/dist/mutations.d.ts

@@ -1,44 +1,46 @@
-import type { VenlyFinanceClient } from "@venlyfinance/sdk";
+import type { FundflowClient, VenlyFinanceClient } from "@venlyfinance/sdk";
 type CreateVibaBody = Parameters<VenlyFinanceClient["virtualBankAccounts"]["create"]>[1];
 type CreatePaymentSessionBody = Parameters<VenlyFinanceClient["paymentSessions"]["create"]>[1];
 /** Create a party (individual or organisation), then refresh party lists. */
 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?: {
@@ -120,4 +125,89 @@ export declare function useCreateRampRequest(): import("@tanstack/react-query").
     fiatCurrencyId: string;
     cryptoCurrencyId: string;
 }, unknown>;
+type SetRampAmountBody = Parameters<FundflowClient["rampRequests"]["setAmount"]>[1];
+type InitiateRampBody = Parameters<FundflowClient["rampRequests"]["initiate"]>[1];
+/** Whitelist a company bank account (created PENDING, verified out-of-band). */
+export declare function useCreateCompanyBankAccount(): import("@tanstack/react-query").UseMutationResult<import("@venlyfinance/sdk").CompanyBankAccountDetails, Error, import("@venlyfinance/sdk").CreateCompanyBankAccountInput, unknown>;
+/** Whitelist a company wallet (created PENDING; prove ownership out-of-band). */
+export declare function useCreateCompanyWallet(): import("@tanstack/react-query").UseMutationResult<{
+    id?: string;
+    companyId?: string;
+    description?: string;
+    address?: string;
+    chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    verifiedAt?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    version?: number;
+}, Error, {
+    description?: string;
+    address: string;
+    chain: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+}, unknown>;
+/** Edit a ramp amount while AWAITING_APPROVAL; carries the optimistic lock. */
+export declare function useSetRampAmount(): import("@tanstack/react-query").UseMutationResult<{
+    id?: string;
+    companyId?: string;
+    companyName?: string;
+    rampType?: "ON_RAMP" | "OFF_RAMP";
+    status?: "AWAITING_APPROVAL" | "AWAITING_FUNDS" | "PROCESSING" | "SUCCEEDED" | "FAILED" | "BLOCKED" | "DENIED" | "REJECTED" | "CANCELLED";
+    amount?: number;
+    netAmount?: number;
+    fiatAmount?: number;
+    fiatNetAmount?: number;
+    cryptoAmount?: number;
+    fiatFeeAmount?: number;
+    exchangeRate?: number;
+    feePercentage?: number;
+    paymentReference?: string;
+    paymentReceived?: boolean;
+    blockchainTransactionHash?: string;
+    createdAt?: string;
+    companyBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireCompanyBankAccountDto"];
+    companyWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CompanyWalletDto"];
+    depositBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireDepositBankAccountDto"];
+    depositWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["DepositWalletDto"];
+    fiatCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatCurrencyDto"];
+    cryptoCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoCurrencyDto"];
+    events?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["RampRequestEventDto"][];
+    version?: number;
+    amountReceived?: number;
+}, Error, {
+    id: string;
+    body: SetRampAmountBody;
+}, unknown>;
+/** Report the off-ramp crypto leg's transaction hash (initiates processing). */
+export declare function useInitiateRamp(): import("@tanstack/react-query").UseMutationResult<{
+    id?: string;
+    companyId?: string;
+    companyName?: string;
+    rampType?: "ON_RAMP" | "OFF_RAMP";
+    status?: "AWAITING_APPROVAL" | "AWAITING_FUNDS" | "PROCESSING" | "SUCCEEDED" | "FAILED" | "BLOCKED" | "DENIED" | "REJECTED" | "CANCELLED";
+    amount?: number;
+    netAmount?: number;
+    fiatAmount?: number;
+    fiatNetAmount?: number;
+    cryptoAmount?: number;
+    fiatFeeAmount?: number;
+    exchangeRate?: number;
+    feePercentage?: number;
+    paymentReference?: string;
+    paymentReceived?: boolean;
+    blockchainTransactionHash?: string;
+    createdAt?: string;
+    companyBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftCompanyBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireCompanyBankAccountDto"];
+    companyWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CompanyWalletDto"];
+    depositBankAccount?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["EurSepaDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpChapsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["GbpFpsDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["OtherCurrencySwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsAchDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsSwiftDepositBankAccountDto"] | import("@venlyfinance/sdk").FundflowComponents["schemas"]["UsWireDepositBankAccountDto"];
+    depositWallet?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["DepositWalletDto"];
+    fiatCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatCurrencyDto"];
+    cryptoCurrency?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoCurrencyDto"];
+    events?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["RampRequestEventDto"][];
+    version?: number;
+    amountReceived?: number;
+}, Error, {
+    id: string;
+    body: InitiateRampBody;
+}, unknown>;
 export {};

package/dist/mutations.js

@@ -56,3 +56,51 @@ export function useCreateRampRequest() {
         },
     });
 }
+/** Whitelist a company bank account (created PENDING, verified out-of-band). */
+export function useCreateCompanyBankAccount() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (body) => fundflow.bankAccounts.create(body),
+        onSuccess: (account) => {
+            if (account.id)
+                queryClient.setQueryData(venlyKeys.companyBankAccount(account.id), account);
+            void queryClient.invalidateQueries({ queryKey: ["venly", "company-bank-accounts"] });
+        },
+    });
+}
+/** Whitelist a company wallet (created PENDING; prove ownership out-of-band). */
+export function useCreateCompanyWallet() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (body) => fundflow.companyWallets.create(body),
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: ["venly", "company-wallets"] });
+        },
+    });
+}
+/** Edit a ramp amount while AWAITING_APPROVAL; carries the optimistic lock. */
+export function useSetRampAmount() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (input) => fundflow.rampRequests.setAmount(input.id, input.body),
+        onSuccess: (ramp, input) => {
+            queryClient.setQueryData(venlyKeys.rampRequest(input.id), ramp);
+            void queryClient.invalidateQueries({ queryKey: ["venly", "ramp-requests"] });
+        },
+    });
+}
+/** Report the off-ramp crypto leg's transaction hash (initiates processing). */
+export function useInitiateRamp() {
+    const { fundflow } = useVenly();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (input) => fundflow.rampRequests.initiate(input.id, input.body),
+        onSuccess: (ramp, input) => {
+            queryClient.setQueryData(venlyKeys.rampRequest(input.id), ramp);
+            void queryClient.invalidateQueries({ queryKey: ["venly", "ramp-requests"] });
+        },
+    });
+}

package/dist/provider.d.ts

@@ -62,5 +62,5 @@ export declare function useVenly(): VenlyClients;
  */
 export declare function useVenlyMock(): {
     finance: import("@venlyfinance/sdk").VenlyFinanceMock | undefined;
-    fundflow: import("@venlyfinance/sdk").VenlyMock | undefined;
+    fundflow: import("@venlyfinance/sdk").VenlyFundflowMock | undefined;
 };

package/dist/queries.d.ts

@@ -1,18 +1,18 @@
 import { type UseQueryOptions } from "@tanstack/react-query";
-import { venlyQueries, type AccountsQuery, type FeeQuoteInput, type PartiesQuery, type RampRequestsQuery, type TransfersQuery, type VirtualBankAccountsQuery, type WalletsQuery } from "./query-options.js";
+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<{
     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,34 @@ 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"]>>;
 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 +85,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 +103,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;
@@ -197,4 +197,81 @@ 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<{
+    id?: string;
+    name?: string;
+    bankName?: string;
+    bankCountry?: string;
+    bankAccountType?: "EUR_SEPA" | "USD_WIRE" | "USD_ACH" | "USD_SWIFT" | "GBP_FPS" | "GBP_CHAPS" | "OTHER_SWIFT";
+    supportedRampType?: "ON_RAMP" | "OFF_RAMP" | "ON_AND_OFF_RAMP";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    createdAt?: string;
+    updatedAt?: string;
+}>>, Error>;
+type BankAccountsPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.companyBankAccounts>["queryFn"]>>;
+export declare function useCompanyBankAccount(id: string | undefined, options?: Tune<BankAccountDetail>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    id?: string;
+    companyId?: string;
+    name?: string;
+    bankName?: string;
+    companyName?: string;
+    email?: string;
+    phoneNumber?: string;
+    bankCountry?: string;
+    beneficiaryAddressLine1?: string;
+    beneficiaryAddressLine2?: string;
+    beneficiaryCity?: string;
+    beneficiaryState?: string;
+    beneficiaryPostalCode?: string;
+    beneficiaryCountry?: string;
+    bankAccountType?: "EUR_SEPA" | "USD_WIRE" | "USD_ACH" | "USD_SWIFT" | "GBP_FPS" | "GBP_CHAPS" | "OTHER_SWIFT";
+    supportedRampType?: "ON_RAMP" | "OFF_RAMP" | "ON_AND_OFF_RAMP";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    verifiedAt?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    version?: number;
+} & {
+    iban?: string;
+    bic?: string;
+    intermediaryBic?: string;
+    intermediaryBankName?: string;
+    accountNumber?: string;
+    sortCode?: string;
+    routingNumber?: string;
+    bankStreetAddress?: string;
+    bankCity?: string;
+    bankPostalCode?: string;
+    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<{
+    id?: string;
+    description?: string;
+    address?: string;
+    chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+    verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+    createdAt?: string;
+    updatedAt?: string;
+}>>, Error>;
+type WalletsListPage = Awaited<ReturnType<ReturnType<typeof venlyQueries.companyWallets>["queryFn"]>>;
+export declare function useBankAccountConfig(options?: Tune<BankAccountConfigData>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    enabledAccountTypes?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["BankAccountTypeDto"][];
+    supportedCountries?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CountryDto"][];
+    supportedCurrencies?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CurrencyItemDto"][];
+}>, Error>;
+type BankAccountConfigData = Awaited<ReturnType<ReturnType<typeof venlyQueries.bankAccountConfig>["queryFn"]>>;
+export declare function useDepositWallets(query?: DepositWalletsQuery, options?: Tune<DepositWalletsData>): import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    id?: string;
+    address?: string;
+    chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+    label?: string;
+    isDefault?: boolean;
+    isActive?: boolean;
+    version?: number;
+}[]>, Error>;
+type DepositWalletsData = Awaited<ReturnType<ReturnType<typeof venlyQueries.depositWallets>["queryFn"]>>;
+/** Supported on/off-ramp currency pairs, for destination/asset pickers. */
+export declare function useRampPairs(direction: "on" | "off", options?: Tune<RampPairsData>): import("@tanstack/react-query").UseQueryResult<NoInfer<RampPairsData>, Error>;
+type RampPairsData = Awaited<ReturnType<ReturnType<typeof venlyQueries.rampPairs>["queryFn"]>>;
 export {};

package/dist/queries.js

@@ -89,3 +89,40 @@ export function useFeeQuote(input, options) {
         ...options,
     });
 }
+export function useCompanyBankAccounts(query, options) {
+    const clients = useVenly();
+    return useQuery({ ...venlyQueries.companyBankAccounts(clients, query), ...options });
+}
+export function useCompanyBankAccount(id, options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.companyBankAccount(clients, id ?? ""),
+        enabled: Boolean(id) && (options?.enabled ?? true),
+        ...options,
+    });
+}
+export function useCompanyWallets(query, options) {
+    const clients = useVenly();
+    return useQuery({ ...venlyQueries.companyWallets(clients, query), ...options });
+}
+export function useBankAccountConfig(options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.bankAccountConfig(clients),
+        staleTime: Infinity, // enabled types/countries change on deploys, not minutes
+        ...options,
+    });
+}
+export function useDepositWallets(query, options) {
+    const clients = useVenly();
+    return useQuery({ ...venlyQueries.depositWallets(clients, query), ...options });
+}
+/** Supported on/off-ramp currency pairs, for destination/asset pickers. */
+export function useRampPairs(direction, options) {
+    const clients = useVenly();
+    return useQuery({
+        ...venlyQueries.rampPairs(clients, direction),
+        staleTime: Infinity,
+        ...options,
+    });
+}

package/dist/query-options.d.ts

@@ -7,6 +7,9 @@ export type VirtualBankAccountsQuery = NonNullable<Parameters<VenlyFinanceClient
 export type TransfersQuery = NonNullable<Parameters<VenlyFinanceClient["transfers"]["list"]>[1]>;
 export type RampRequestsQuery = NonNullable<Parameters<FundflowClient["rampRequests"]["list"]>[0]>;
 export type FeeQuoteInput = Parameters<FundflowClient["fees"]["calculate"]>[0];
+export type CompanyBankAccountsQuery = NonNullable<Parameters<FundflowClient["bankAccounts"]["list"]>[0]>;
+export type CompanyWalletsQuery = NonNullable<Parameters<FundflowClient["companyWallets"]["list"]>[0]>;
+export type DepositWalletsQuery = NonNullable<Parameters<FundflowClient["referenceData"]["depositWallets"]>[0]>;
 /**
  * Pure `{ queryKey, queryFn }` factories, one per read. The hooks in
  * queries.ts are one-line wrappers over these; anything that needs the same
@@ -18,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;
@@ -37,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;
@@ -57,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;
         }>>;
@@ -69,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;
         }>;
@@ -78,12 +81,9 @@ 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"];
         }>>;
     };
     readonly virtualBankAccounts: (clients: VenlyClients, accountId: string, query?: VirtualBankAccountsQuery) => {
@@ -91,16 +91,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;
         }>>;
@@ -111,14 +114,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;
@@ -131,14 +134,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;
@@ -241,4 +244,64 @@ export declare const venlyQueries: {
             percentage?: number;
         }>;
     };
+    readonly companyBankAccounts: (clients: VenlyClients, query?: CompanyBankAccountsQuery) => {
+        queryKey: readonly ["venly", "company-bank-accounts", {} | null];
+        queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
+            id?: string;
+            name?: string;
+            bankName?: string;
+            bankCountry?: string;
+            bankAccountType?: "EUR_SEPA" | "USD_WIRE" | "USD_ACH" | "USD_SWIFT" | "GBP_FPS" | "GBP_CHAPS" | "OTHER_SWIFT";
+            supportedRampType?: "ON_RAMP" | "OFF_RAMP" | "ON_AND_OFF_RAMP";
+            verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+            createdAt?: string;
+            updatedAt?: string;
+        }>>;
+    };
+    readonly companyBankAccount: (clients: VenlyClients, id: string) => {
+        queryKey: readonly ["venly", "company-bank-account", string];
+        queryFn: () => Promise<import("@venlyfinance/sdk").CompanyBankAccountDetails>;
+    };
+    readonly companyWallets: (clients: VenlyClients, query?: CompanyWalletsQuery) => {
+        queryKey: readonly ["venly", "company-wallets", {} | null];
+        queryFn: () => Promise<import("@venlyfinance/sdk").Page<{
+            id?: string;
+            description?: string;
+            address?: string;
+            chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+            verificationStatus?: "PENDING" | "VERIFIED" | "DENIED";
+            createdAt?: string;
+            updatedAt?: string;
+        }>>;
+    };
+    readonly bankAccountConfig: (clients: VenlyClients) => {
+        queryKey: readonly ["venly", "bank-account-config"];
+        queryFn: () => Promise<{
+            enabledAccountTypes?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["BankAccountTypeDto"][];
+            supportedCountries?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CountryDto"][];
+            supportedCurrencies?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CurrencyItemDto"][];
+        }>;
+    };
+    readonly depositWallets: (clients: VenlyClients, query?: DepositWalletsQuery) => {
+        queryKey: readonly ["venly", "deposit-wallets", {} | null];
+        queryFn: () => Promise<{
+            id?: string;
+            address?: string;
+            chain?: "ETHEREUM" | "POLYGON" | "BASE" | "ARBITRUM" | "SUI";
+            label?: string;
+            isDefault?: boolean;
+            isActive?: boolean;
+            version?: number;
+        }[]>;
+    };
+    readonly rampPairs: (clients: VenlyClients, direction: "on" | "off") => {
+        queryKey: readonly ["venly", "ramp-pairs", "on" | "off"];
+        queryFn: () => Promise<{
+            from?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatPairItem"];
+            to?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoPairItem"];
+        }[]> | Promise<{
+            from?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["CryptoPairItem"];
+            to?: import("@venlyfinance/sdk").FundflowComponents["schemas"]["FiatPairItem"];
+        }[]>;
+    };
 };

package/dist/query-options.js

@@ -70,4 +70,30 @@ export const venlyQueries = {
         queryKey: venlyKeys.feeQuote(input),
         queryFn: () => clients.fundflow.fees.calculate(input),
     }),
+    companyBankAccounts: (clients, query) => ({
+        queryKey: venlyKeys.companyBankAccounts(query),
+        queryFn: () => clients.fundflow.bankAccounts.list(query),
+    }),
+    companyBankAccount: (clients, id) => ({
+        queryKey: venlyKeys.companyBankAccount(id),
+        queryFn: () => clients.fundflow.bankAccounts.get(id),
+    }),
+    companyWallets: (clients, query) => ({
+        queryKey: venlyKeys.companyWallets(query),
+        queryFn: () => clients.fundflow.companyWallets.list(query),
+    }),
+    bankAccountConfig: (clients) => ({
+        queryKey: venlyKeys.bankAccountConfig(),
+        queryFn: () => clients.fundflow.referenceData.bankAccountConfig(),
+    }),
+    depositWallets: (clients, query) => ({
+        queryKey: venlyKeys.depositWallets(query),
+        queryFn: () => clients.fundflow.referenceData.depositWallets(query),
+    }),
+    rampPairs: (clients, direction) => ({
+        queryKey: venlyKeys.rampPairs(direction),
+        queryFn: () => direction === "on"
+            ? clients.fundflow.rampRequests.onRampPairs()
+            : clients.fundflow.rampRequests.offRampPairs(),
+    }),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venlyfinance/react",
-  "version": "0.1.1",
+  "version": "0.3.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.2.0"
+    "@venlyfinance/sdk": "^0.4.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"
-}
+}