bluefin

Explain Bluefin Protocol's perpetual futures architecture on Sui with off-chain order matching and on-chain settlement.

3|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/mcxross/skills --skill bluefin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluefin
Source: https://github.com/mcxross/skills/tree/main/bluefin
Command: npx skills add https://github.com/mcxross/skills --skill bluefin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Clarifies how Bluefin Protocol on Sui enables perpetual futures trading with off-chain order matching and on-chain settlement, along with asset custody via AssetBank and vault mechanics.

Core Features & Use Cases

  • Understand the architecture: ExternalDataStore, InternalDataStore, AssetBank, Perpetuals, and Vault modules.
  • Explore deposit and settlement flows: depositing collateral to AssetBank and executing trades via signed payloads verified on-chain.
  • Review vault operations and margining: cross-margin and isolated-margin positions, funding, and ADL behavior.
  • Use case: developers evaluating integration into a Sui-based DeFi project or researchers auditing security and coherence of the protocol.

Quick Start

Deposit USDC to the AssetBank and inspect a perpetual position to observe margin and funding.

Frequently Asked Questions about bluefin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does off-chain order matching with on-chain settlement work for perpetual futures on Sui?▼

Off-chain order matching on Sui works by having matchers pair orders externally, then submitting signed payloads to the chain for verification and settlement. The protocol verifies these signatures on-chain before updating InternalDataStore and Perpetuals modules.

How do I deposit collateral to start trading perpetuals on Bluefin?▼

To deposit collateral for trading perpetuals on Bluefin, you deposit USDC into the AssetBank module. This action credits your account, allowing you to open cross-margin or isolated-margin positions via signed payloads.

What is the difference between cross-margin and isolated-margin positions in this protocol?▼

Cross-margin positions share collateral across your entire account to prevent liquidations, while isolated-margin positions restrict risk to the specific collateral allocated to an individual perpetual position, protecting the broader account balance.

Can I use signed payloads to execute trades and manage margin on Sui?▼

Yes, you can use signed payloads to execute trades and manage margin on Sui. Signers generate these payloads off-chain, which the protocol then verifies on-chain to authorize deposits, trades, and liquidations securely.

How does the Vault module handle liquidations and funding for perpetual futures?▼

The Vault module handles liquidations and funding by managing collateral flows and enforcing Auto-Deleveraging (ADL) behavior. It ensures that undercollateralized positions are liquidated and funding rates are applied to perpetual contracts.