developer portal

everything you need to build with virio

SDKs, interactive API references, event schemas, and copy-paste examples. ship onchain billing without becoming a payments team.

Quickstart

Install a package, point it at the manager contract, and make your first call. Every SDK is typed end-to-end and tree-shakeable.

@virio/sdk
Core TypeScript SDK
18 kB
@virio/sdk/react
Native React components
9 kB
@virio/sdk/vue
Native Vue plugin
4 kB
@virio/sdk/angular
Native Angular bindings
4 kB
@virio/sdk/web
Framework-neutral Web Component
4 kB
@virio/contracts
Solidity interfaces & ABIs
1npm install @virio/sdk

API reference

Try every endpoint live — responses are returned inline.

Create a subscription product

Copy-paste examples

React, Next.js, Solidity, and webhook payloads — ready to drop in.

Subscribe.tsx
1import { VirioButton, VirioProvider } from "@virio/sdk/react";
2 
3export function Subscribe({ planId }: { planId: string }) {
4 return (
5 <VirioProvider rpcUrl={process.env.NEXT_PUBLIC_RPC_URL!}>
6 <VirioButton planId={planId}>Subscribe $49/mo</VirioButton>
7 </VirioProvider>
8 );
9}

Execution lifecycle

Every subscription and payroll run follows the same five stages.

1
createProduct / payroll defined
2
approveCustomer signs once
3
scheduleAgreement becomes due
4
executeExecutor triggers settlement
5
settleFees split, funds delivered

Event schemas

Webhook event types delivered to your endpoint.

subscription.chargedA recurring charge settles
subscription.failedA charge reverts onchain
subscription.cancelledAn agreement is cancelled
payroll.executedA payroll run completes
executor.reward.paidAn executor is paid its fee

Ready to go live?

Spin up the dashboard, create a product, and start settling onchain.

launch dashboard