Send your first SMS
in 60 seconds

1npm install @dial/api @x402/fetch
2
3# Or with yarn
4yarn add @dial/api @x402/fetch
5
6# Or with pnpm
7pnpm add @dial/api @x402/fetch

1import { DialClient } from "@dial/api";
2import { wrapFetchWithPayment } from "@x402/fetch";
3import { x402Client } from "@x402/core/client";
4import { ExactEvmScheme } from "@x402/evm/exact/client";
5import { toClientEvmSigner } from "@x402/evm";
6
7// Create your x402 payment wrapper
8const signer = toClientEvmSigner(walletClient);
9const client = new x402Client();
10client.register("eip155:*", new ExactEvmScheme(signer));
11const paidFetch = wrapFetchWithPayment(fetch, client);
12
13// Initialize Dial
14const dial = new DialClient({
15  baseUrl: "https://x402.dial.wtf",
16  x402Fetch: paidFetch,
17});

1// Buy a US phone line ($100 activation)
2const { number } = await dial.numbers.buyUs({
3  country: "US",
4});
5
6console.log("Your new number:", number);
7// → +1 (555) 123-4567
8
9// Or buy an international line
10const { number: intlNumber } = await dial.numbers.buyIntl({
11  country: "GB",
12});

1// Send an SMS from your number
2const message = await dial.messages.send({
3  to: "+1234567890",
4  from: number,
5  body: "Hello from Dial! 👋",
6});
7
8console.log("Message ID:", message.id);
9console.log("Status:", message.status);
10// → queued
11
12// Check delivery status
13const status = await dial.messages.get(message.id);
14console.log("Delivery:", status.deliveryState);
15// → delivered