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

# Overview

> Gasless and gasfree transactions on Starknet

Let users pay gas in any token, or sponsor it entirely so they pay nothing. avnu pioneered paymaster on Starknet ([SNIP-9](https://github.com/starknet-io/SNIPs/blob/main/SNIPS/snip-9.md), [SNIP-29](https://github.com/starknet-io/SNIPs/blob/main/SNIPS/snip-29.md)) - now powering 50+ dApps.

<a href="https://portal.avnu.fi" target="_blank">
  <img src="https://mintcdn.com/avnu/Hl-5jkqdwaeePibe/images/portal-og.png?fit=max&auto=format&n=Hl-5jkqdwaeePibe&q=85&s=4f5395e79a5b3206c7bc6809fb39d51f" alt="avnu Portal - Sponsor gas for your users" style={{ display: 'block', width: '100%', borderRadius: '12px', boxShadow: '0 4px 24px rgba(0,0,0,0.12)', pointerEvents: 'none' }} width="1200" height="630" data-path="images/portal-og.png" />
</a>

<div style={{ textAlign: 'center', marginTop: '12px', marginBottom: '24px' }}>
  <a href="https://portal.avnu.fi" target="_blank" style={{
    display: 'inline-block',
    color: 'white',
    background: '#3761F6',
    textDecoration: 'none',
    fontWeight: 600,
    fontSize: '14px',
    padding: '10px 20px',
    borderRadius: '8px',
    border: 'none'
  }}>Get your API key</a>
</div>

## Pick your mode

| Mode        | Who pays                      | Setup            |
| ----------- | ----------------------------- | ---------------- |
| **Gasfree** | You sponsor all gas           | Portal + API key |
| **Gasless** | User pays in USDC, USDT, etc. | No setup needed  |

***

## Gasfree: you sponsor gas

Best for onboarding, gaming, and premium UX. Your dApp covers gas - users transact for free.

<Card title="Gasfree integration" icon="gift" href="/docs/paymaster/gasfree">
  Portal setup, API keys, credits, and code
</Card>

<Card title="Propulsion Program" icon="rocket" href="/docs/paymaster/propulsion-program">
  Get up to \$1M in gas subsidies from Starknet Foundation
</Card>

***

## Gasless: user pays in tokens

Users pay gas in any supported token instead of STRK. No API key required.

```typescript theme={null}
import { PaymasterRpc } from 'starknet';

const paymaster = new PaymasterRpc({
  nodeUrl: 'https://starknet.paymaster.avnu.fi',
});

// User pays gas in USDC instead of STRK
const result = await account.execute(calls, {
  paymaster: {
    provider: paymaster,
    params: {
      version: '0x1',
      feeMode: {
        mode: 'default',
        gasToken: '0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8' // USDC
      }
    }
  }
});
```

<Tip>
  **Supported tokens:** USDC, USDT, DAI, ETH, STRK, WBTC, solvBTC, LBTC, EKUBO, NSTR, LORDS, wstETH - more added regularly.
</Tip>

***

## Resources

<Tabs>
  <Tab title="starknet.js">
    [starknetjs.com/docs/guides/account/paymaster](https://starknetjs.com/docs/guides/account/paymaster)
  </Tab>

  <Tab title="starknet-react">
    [starknet-react.com/docs/paymaster-providers](https://www.starknet-react.com/docs/paymaster-providers)
  </Tab>

  <Tab title="Self-hosted">
    Need full control? [Open-source repo](https://github.com/avnu-labs/paymaster)
  </Tab>
</Tabs>