Skip to main content
Gasless transactions are only available in Starknet Mainnet.
1

Configure your Authentication

You’ll need to add the JWKS Endpoint from your auth provider to authenticate gasless transactions.
With this JWKS Endpoint setup, you can now run secure code in your frontend using a rotating JWT token.

Getting your JWKS Endpoint

For these common auth providers, you can get your JWKS Endpoint like this:
  1. Go to your API Keys
  2. Copy your JWKS Endpoint and paste it into the JWKS Endpoint field in your Chipi Dashboard.
  3. Follow our documentation to add Clerk and Chipi to your application.
2

Get your Public Key

Now go to your Credentials page and click on your project.Which will give you access to your Public Key (pk_prod_xxxx). Keep this handy as you’ll need it to initialize the SDK.
You won’t need the Secret Key (sk_prod_xxxx) for now.
3

Install the SDK

4

Initialize the SDK

  1. Add your Public Key to your environment variables.
Never put CHIPI_SECRET_KEY in an Expo app — the SDK explicitly forbids it at the type level via ChipiBrowserSDKConfig. Secret keys belong on your backend only.
  1. Wrap your main _layout.tsx with the ChipiProvider component.
5

Start Using the SDK

You’re ready to use the SDK! We recommend starting with our convenience hooks that simplify common operations:

useChipiWallet - Unified Wallet Management

useChipiWallet Documentation

Learn about all the options and return values

useChipiSession - Gasless Session Keys (CHIPI wallets only)

useChipiSession Documentation

Learn about session key management
6

Next Steps

That’s it! You should now have an initial working version of Chipi Pay integrated into your application. Explore more features:Need help? Join our Telegram Community to ask us anything on your mind.