gigadex-sdk

The community Python SDK for building on GigaDex on Robinhood Chain.

gigadex-sdk gives Python developers a small, typed foundation for reading GigaDex data, working with concentrated-liquidity prices and ticks, loading verified contract ABIs, and preparing Web3 integrations.

It is useful for:

• liquidity keepers and range-management bots
• portfolio dashboards
• analytics and reporting scripts
• research notebooks
• trading and automation tools

This SDK is community maintained. Review all transactions yourself before sending funds on-chain.

Features

• GigaDex GraphQL client for tokens, pools, positions, and portfolio state.
• Typed Pydantic models for safer application code.
• Concentrated-liquidity math for ticks, prices, ranges, and tick-spacing alignment.
• Packaged ABI loading for common GigaDex/Web3 contract interactions.
• Web3 helpers for contracts, chain validation, gas checks, signing, and sending transactions.
• Modern Python packaging with uv, pyproject.toml, and Python 3.11+ support.

Installation

With uv:

uv add gigadex-sdk

With pip:

pip install gigadex-sdk

Quick start

Fetch portfolio data

from gigadex_sdk.graphql_client import GigaDexGraphQLClient

GRAPHQL_URL = "https://edge.gigadex.fi/v1/graphql"
CHAIN_ID = 4663
ACCOUNT = "0x2d438b5f9dbb11fb406a92fd97476f4cdc9947d1"

client = GigaDexGraphQLClient(GRAPHQL_URL)
portfolio = client.fetch_portfolio(chain_id=CHAIN_ID, account=ACCOUNT)

for position in portfolio.positions:
    print(position.token_id, position.pool, position.tick_lower, position.tick_upper)

Work with concentrated-liquidity ticks

from decimal import Decimal

from gigadex_sdk.math import percentage_range_ticks, range_width_percent

current_tick = -200_000
tick_spacing = 10

tick_lower, tick_upper = percentage_range_ticks(
    current_tick=current_tick,
    percent_each_side=Decimal("5"),
    tick_spacing=tick_spacing,
)

lower_pct, upper_pct = range_width_percent(tick_lower, tick_upper, current_tick)

print(tick_lower, tick_upper)
print(f"range: -{lower_pct:.2f}% / +{upper_pct:.2f}%")

Load packaged ABIs

from gigadex_sdk.abis import ERC20_ABI, POSITION_MANAGER_ABI

print(len(ERC20_ABI))
print(len(POSITION_MANAGER_ABI))

Create a Web3 contract

from gigadex_sdk.abis import ERC20_ABI
from gigadex_sdk.chain import ChainClient

# ChainClient expects a small settings object with rpc_url, chain_id,
# account/private-key settings, and gas controls. See README-DEV.md for
# development details and examples.
token = chain_client.contract("0xTokenAddress", ERC20_ABI)

Common constants

GIGADEX_GRAPHQL_URL = "https://edge.gigadex.fi/v1/graphql"
ROBINHOOD_CHAIN_ID = 4663

Project status

gigadex-sdk is early software. The current focus is reliable read access, reusable data models, concentrated-liquidity math, and safe building blocks for bot authors.

On-chain write helpers are intentionally low-level. Applications should add their own policy layer for slippage, gas limits, simulation, private-key handling, retries, alerts, and human review.

Contributing

Contributions are welcome. For development setup, test commands, release steps, and PyPI publishing notes, see README-DEV.md.

License

MIT