Session Keys

Session keys allow traders to interact with Katana Perps without manually approving every transaction in their wallet. They provide a streamlined, one-click trading experience while maintaining security through scoped permissions and expiration controls.

How Session Keys Work

When you connect your wallet to Katana Perps for the first time, the platform generates a session key — a temporary, limited-permission signing key that is authorized by your primary wallet. Once a session key is active, all subsequent actions (placing orders, canceling orders, etc.) are signed by the session key automatically, without requiring you to confirm each transaction in your wallet popup.

Session keys are scoped exclusively to trading actions on Katana Perps. They cannot be used to withdraw funds, transfer assets, or interact with any other application. This means that even if a session key were compromised, it could not be used to move your funds out of the exchange.

Key Properties

  • Automatic signing — Orders and cancellations are signed instantly without wallet popups, enabling real-time trading.

  • Scoped permissions — Session keys can only perform trading actions. They have no authority over deposits, withdrawals, or any external transactions.

  • Time-limited — Session keys expire after a defined period and must be re-authorized by the primary wallet.

  • Revocable — You can revoke an active session key at any time from the exchange interface, immediately terminating its signing authority.

  • Valid for 30 days — Session keys expire after 30 days.

circle-info

Security Considerations

Session keys are a common pattern in high-performance decentralized applications. They allow Katana Perps to deliver a user experience comparable to centralized exchanges — where actions happen instantly without confirmation dialogs — without ever taking custody of your funds or asking you to share your private key.

Your primary wallet key is used only to authorize the session key and to sign deposit and withdrawal transactions. It is never exposed to the trading interface during normal operation.

Last updated