> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tribridge.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Tribridge is a crypto payment gateway for Solana and Sui (TON is coming soon). API base URL is https://tribridge.onrender.com. Server-side calls authenticate with the x-api-key header using a tri_test_... key (fully simulated test mode, no real funds) or tri_live_... key (real mainnet payments) — never expose keys client-side. Merchant test mode is simulated, not testnet. Refunds are automatic only (underpaid/overpaid), there is no manual refund endpoint. Always verify webhook HMAC-SHA256 signatures from the X-Tribridge-Signature header before trusting payloads.

# SDKs & Libraries

> Official Tribridge SDKs for JavaScript and PHP are coming soon. The REST API works today.

<Note>
  Official SDKs are **coming soon**. Until then, the REST API below is stable, fully supported, and all you need — every SDK will be a thin wrapper over it.
</Note>

## Planned SDKs

<CardGroup cols={2}>
  <Card title="JavaScript / TS — coming soon" icon="code">
    Ideal for Node.js backends and modern web applications.

    ```bash theme={null}
    npm install @tribridge/sdk
    ```
  </Card>

  <Card title="PHP / Laravel — coming soon" icon="server">
    First-class support for Laravel through our official bridge package.

    ```bash theme={null}
    composer require tribridge/payment-bridge
    ```
  </Card>
</CardGroup>

Planned usage (JavaScript) — this is the shape the SDK will take:

```javascript Planned SDK usage (not yet published) theme={null}
import { TriBridge } from '@tribridge/sdk';

const tb = new TriBridge('tri_test_...');

const payment = await tb.payments.create({
  amount: 99.00,
  currency: 'USD',
  redirect_url: 'https://yoursite.com/success'
});

console.log(payment.deposit_address);
```

## Wallet SDK & address architecture — coming soon

A dedicated wallet infrastructure SDK for businesses that need to generate and manage payment addresses directly — HD-derived deposit addresses, balance monitoring hooks, and sweep controls without going through hosted checkout. Pricing and availability will be announced at launch. Until then, hosted checkout + webhooks cover every payment flow.

## Using the REST API today

You lose nothing by integrating directly — this is exactly what the SDKs will call:

1. `POST /payments` with your `x-api-key` → get `checkout_url` (see [Creating Payments](/payments)).
2. Send the customer to the URL; handle `payment.completed` in your [webhook handler](/webhooks).
3. [Verify signatures](/authentication) and [track the lifecycle](/lifecycle) — the same steps the SDK will automate.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.