accessKey.saveAuthorization

Saves a signed key authorization to a relay running the Key Authorization plugin. The relay attaches it to the access key's next transaction until the key is active onchain.

accessKey.signAuthorization already saves authorizations it signs through a relay. Use this action for authorizations signed elsewhere, such as on another device or with account.signKeyAuthorization.

Usage

import { Account, P256 } from 'viem/tempo'
import { client } from './viem.config'
 
const account = Account.fromSecp256k1('0x...')
const accessKey = Account.fromP256(P256.randomPrivateKey(), {
  access: account,
})
 
const keyAuthorization = await account.signKeyAuthorization(accessKey, {
  chainId: client.chain.id,
  expiry: Math.floor(Date.now() / 1000) + 86_400,
})
 
await client.accessKey.saveAuthorization({ keyAuthorization })

import { Client, http, Relay, Store, withRelay } from 'viem/tempo'
 
export const client = Client.create({
  transport: withRelay(http(), {
    plugins: [Relay.keyAuthorization({ store: Store.memory() })],
  }),
})

Standalone Action

Call Actions.accessKey.saveAuthorization directly by passing the Client as the first argument.

import { Actions } from 'viem/tempo'
import type { KeyAuthorization } from 'ox/tempo'
import { client } from './viem.config'
 
declare const keyAuthorization: KeyAuthorization.Signed
 
await Actions.accessKey.saveAuthorization(client, { keyAuthorization })

Return Value

void

Resolves once the relay has stored the authorization, or has skipped it because the key is already active onchain.

Parameters

keyAuthorization

• Type: KeyAuthorization.Signed

The signed key authorization to save. It must be signed by the account itself (a root key or an owner quorum), unexpired, and for the relay's chain. A pending authorization for the same key is only replaced when the new one expires later.

Errors