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

# Renaiss Documentation

> Build on Renaiss with APIs, SDKs, and identity tools for collectible card applications.

Build on Renaiss with APIs, SDKs, and identity tools for real-world collectible card applications. Use these docs to authenticate users, browse gacha machines, prepare wallets, stream pull progress, and submit buybacks.

<Note>
  RENAISS is an independent marketplace for authentic collectible cards. RENAISS is not affiliated with or endorsed by The Pokémon Company, Nintendo, Shueisha Inc., Eiichiro Oda, or related entities.
</Note>

## Developer quickstart

Make your first SDK call in minutes. Create a public client, fetch active gacha machines, and then move into authenticated wallet workflows when your app needs pulls or buybacks.

```ts theme={null}
import {
  GachaMachineStage,
  createPublicClient,
  getError,
  getValue,
  isFailed,
} from "@renaiss-protocol/client";

const client = createPublicClient();

const machinesResult = await client
  .listGachaMachines({
    pageSize: 5,
    stage: GachaMachineStage.Active,
  })
  .firstPage();

if (isFailed(machinesResult)) {
  throw new Error(getError(machinesResult).detail);
}

for (const machine of getValue(machinesResult).items) {
  console.log(machine.slug, machine.name);
}
```

<Card title="Get started" icon="rocket" href="/quickstart">
  Choose the fastest path for exploring Renaiss, integrating the SDK, or adding SSO.
</Card>

## Get familiar with Renaiss

Learn the main product and developer flows before you build.

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Set up your environment and choose the right integration path.
  </Card>

  <Card title="TypeScript SDK" icon="code" href="/typescript-sdk">
    Browse gacha machines, prepare wallets, pull gacha, stream progress, and submit buybacks.
  </Card>

  <Card title="Sign in with Renaiss" icon="key-round" href="/sso-integration">
    Add Renaiss as an OpenID Connect identity provider for your application.
  </Card>

  <Card title="Renaiss app" icon="external-link" href="https://renaiss.xyz">
    Explore the marketplace and gacha experiences.
  </Card>
</Columns>

## What you can build

* Let users sign in with their Renaiss account through OpenID Connect.
* Fetch gacha machines, machine contents, buyback offers, and user activity through the TypeScript SDK.
* Prepare a user's Safe wallet and Permit2 USDT approval with an approved builder API key.
* Pull gacha, stream progress through draw resolution, track asynchronous token release, and submit builder-authorized buybacks for eligible cards.