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.