Skip to content

Concept: Connexions (Exchange + Wallet)

In Glacez, a "connexion" is a source of portfolio data and potential execution. Two connexion types exist: exchange credentials and wallets.

Exchange credential

An exchange credential represents API-based access to an exchange account.

Main attributes:

  • Exchange-specific identity (name + API keys/secrets)
  • autoSynchronize flag
  • Status lifecycle: DISABLE, IMPORTING, ENABLE

Typical behavior:

  • On creation, connectivity is checked
  • If valid, credential enters import flow (IMPORTING) and records are queued
  • Once import is done, credential can operate in enabled mode

Wallet connexion

A wallet is a set of public addresses grouped under one user-defined wallet name.

Main attributes:

  • Wallet type (LEDGER, METAMASK, MONERO, OTHER)
  • One or more public addresses per chain/currency
  • autoSynchronize flag
  • Status lifecycle: DISABLE, IMPORTING, ENABLE

Wallets are read-only from a key perspective: users connect with public addresses/keys only.

Why connexions are critical

Connexions feed the full product:

  • Balance and transaction imports
  • Position and portfolio updates
  • Strategy execution targeting specific credentials
  • Synchronization and reconciliation workflows

Important constraints

  • Duplicate credential/wallet names are rejected per user
  • Duplicate wallet addresses are rejected for the same user (per supported chain set)
  • Import jobs are published only when connexion status is IMPORTING

Related: