Skip to content

docs: simplify sponsor-user-fees guide — use /relay, remove Step 3 #390

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
decofe wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: simplify sponsor-user-fees guide — use /relay, remove Step 3 #390

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 6 additions & 59 deletions src/pages/guide/payments/sponsor-user-fees.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Enable gasless transactions by sponsoring transaction fees for your users. Tempo
### Set up the fee payer service

:::tip
Tempo provides a public testnet fee payer service at `https://sponsor.moderato.tempo.xyz` that you can use for development and testing. If you want to run your own, follow the instructions below.
For development and testing, point `feePayer` at your local relay endpoint (e.g. `/relay`). All transactions will be sponsored automatically.
:::

You can stand up a minimal fee payer service using the [`Handler.relay`](/accounts/server/handler.relay) handler provided by the [Tempo Accounts SDK](/accounts). To sponsor transactions, you need a funded account that will act as the fee payer.
Expand Down Expand Up @@ -66,7 +66,7 @@ import { tempoWallet } from 'wagmi/connectors'

export const config = createConfig({
connectors: [tempoWallet({
feePayer: 'https://sponsor.moderato.tempo.xyz', // [!code focus]
feePayer: '/relay', // [!code focus]
})],
chains: [tempo],
multiInjectedProviderDiscovery: false,
Expand All @@ -90,73 +90,20 @@ export const config = createConfig({
transports: {
[tempo.id]: withRelay( // [!code focus]
http(), // [!code focus]
http('https://sponsor.moderato.tempo.xyz'), // [!code focus]
http('/relay'), // [!code focus]
), // [!code focus]
},
})
```

:::

### Sponsor your user's transactions
### Send a sponsored transaction

Now transactions will be sponsored by your relay. For more details on how to send a transaction, see the [Send a payment](/guide/payments/send-a-payment) guide.
That's it — all transactions sent through this config will be automatically sponsored by your relay. No additional code is needed on the client side. For more details on how to send a transaction, see the [Send a payment](/guide/payments/send-a-payment) guide.

:::info
You can also build your own fee paying service. See [Build your own fee paying service](#build-your-own-fee-paying-service) below.
:::

:::code-group

```tsx twoslash [SendSponsoredPayment.tsx] filename="SendSponsoredPayment.tsx"
import { Hooks } from 'wagmi/tempo'
import { parseUnits } from 'viem'
import { privateKeyToAccount } from 'viem/accounts'

const alphaUsd = '0x20c0000000000000000000000000000000000001'

// @noErrors
function SendSponsoredPayment() {
const sponsorAccount = privateKeyToAccount('0x...')
const sendPayment = Hooks.token.useTransferSync() // [!code hl]
const metadata = Hooks.token.useGetMetadata({
token: alphaUsd,
})

return (
<form onSubmit={
(event) => {
event.preventDefault()
const formData = new FormData(event.target as HTMLFormElement)

const recipient = (formData.get('recipient') ||
'0x0000000000000000000000000000000000000000') as `0x${string}`

sendPayment.mutate({ // [!code hl]
amount: parseUnits('100', metadata.data.decimals), // [!code hl]
feePayer: sponsorAccount, // [!code focus]
to: recipient, // [!code hl]
token: alphaUsd, // [!code hl]
}) // [!code hl]
}
}>
<div>
<label htmlFor="recipient"> Recipient address </label>
<input type="text" placeholder="0x..." />
</div>
<button type="submit" disabled={sendPayment.isPending}>
Send Payment
</button>
</form>
)
}
```

```tsx twoslash [wagmi.config.ts] filename="wagmi.config.ts"
// @noErrors
// [!include ~/snippets/wagmi.config.ts:withFeePayer]
```

You can also build your own fee paying service for more control. See [Build your own fee paying service](#build-your-own-fee-paying-service) below.
:::

### Next Steps
Expand Down
2 changes: 1 addition & 1 deletion src/snippets/public-testnet-sponsor-tip.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
:::tip
Tempo provides a public testnet fee payer service at `https://sponsor.moderato.tempo.xyz` that you can use for development and testing. If you want to run your own, follow the instructions below.
For development and testing, point `feePayer` at your local relay endpoint (e.g. `/relay`). All transactions will be sponsored automatically.
:::
2 changes: 1 addition & 1 deletion src/snippets/wagmi.config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ export const config = createConfig({
tempoWallet({
feePayer: {
precedence: 'user-first',
url: 'https://sponsor.moderato.tempo.xyz',
url: '/relay',
},
}),
],
Expand Down
Loading