Use a session

Installing sessions

To enable a session: Examples on this page use @rhinestone/sdk, where rhinestone is the RhinestoneSDK instance from Create a session with a custom setup.

import { enableSession } from "@rhinestone/sdk/actions/smart-sessions";

const sessions = [session];
const sessionDetails = await rhinestoneAccount.getSessionDetails(sessions);
const enableSignature =
  await rhinestoneAccount.signEnableSession(sessionDetails);
const sessionIndex = 0;

const transaction = await rhinestoneAccount.prepareTransaction({
  chain,
  calls: [
    enableSession(
      session,
      enableSignature,
      sessionDetails.hashesAndChainIds,
      sessionIndex,
    ),
  ],
});

You can also enable a session with a signature. See Multi-chain sessions for details.

Checking session status

To check if a session is enabled:

const isEnabled = await rhinestoneAccount.isSessionEnabled(session);

Using sessions

To authorize a transaction with a session key you’ve enabled before:

const prepared = await rhinestoneAccount.prepareTransaction({
  chain,
  calls: [
    {
      to: usdcAddress,
      data: encodeFunctionData({
        abi: erc20Abi,
        functionName: "transfer",
        args: ["0xd8da6bf26964af9d7eed9e03e53415d37aa96045", 1n],
      }),
    },
  ],
  signers: {
    type: "session",
    session,
  },
});
const signed = await rhinestoneAccount.signTransaction(prepared);
const transactionResult = await rhinestoneAccount.submitTransaction(signed);

This will prompt the signature request from the session owner(s) and submit the transaction on their behalf.

You can also enable and use the session key in one transaction with the enable mode.

Disabling a session

To disable a single enabled session, use disableSession. This only removes a single session: to uninstall the validator entirely (and every session with it), use disable instead.

import { disableSession } from "@rhinestone/sdk/actions/smart-sessions";

const transaction = await rhinestoneAccount.prepareTransaction({
  chain,
  calls: [disableSession(session)],
});

Embedded wallet

Custom setup

Installing sessions

Checking session status

Using sessions

Disabling a session

​Installing sessions

​Checking session status

​Using sessions

​Disabling a session

Installing sessions

Checking session status

Using sessions

Disabling a session