Skip to content

Instantly share code, notes, and snippets.

View jordaniza's full-sized avatar
🎲
All In

Jordan jordaniza

🎲
All In
View GitHub Profile
@jordaniza
jordaniza / xmaquina-implementation-plan.md
Last active December 2, 2025 13:53
xMaquina DAO Capital Distribution Implementation Plan

xMaquina DAO Capital Distribution Implementation Plan

High-Level Requirements

xMaquina needs a capital distribution system that rewards veToken stakers based on:

  • Their voting power (stake amount)
  • Their stake duration (time locked)
  • Continuous participation over a 30-day distribution period
@jordaniza
jordaniza / avKAT_Integration_Guide.md
Last active December 1, 2025 08:11
avKAT Integration Guide for CEXs and Custodians - KAT/vKAT/avKAT token flows

avKAT Integration Guide for CEXs and Custodians

Overview

avKAT is a derivative of the KAT token that automates governance and yield generation for stakers. This guide covers the essential integration flows for stake/unstake operations.

Key Parameters

  • No minimum lock period - Users can exit anytime
  • Token Mechanics - 1 KAT = 1 vKAT at deposit, but avKAT is an ERC-4626 vault token that accrues yield compounded in KAT, so the exchange rate is expected to drift upward over time.
@jordaniza
jordaniza / aragon-msig-vs-safe.md
Created September 18, 2025 09:45
Aragon Multisig vs Safe comparison for Benqi governance

Summary

In Benqi's optimistic governance flow, a multisig creates governance proposals that veQI token holders can Veto.

The question is: should this Multisig be an Aragon Multisig or a Safe.

Our recommendation is to use an Aragon Multisig for the above governance flow, keeping the existing safe as an emergency multisig.

Our rationale is:

@jordaniza
jordaniza / BondingCurve.md
Created September 16, 2025 10:00
Taikodrome Bonding Contract Specification

Specification: Bonding.sol

1. Overview

Bonding.sol is the core smart contract responsible for bootstrapping the Taikodrome economy. Its primary function is to facilitate the one-way conversion of the native $TAIKO token into max-locked veTD governance positions.

The contract is designed to create a powerful incentive for early, large-scale participation by offering significant, competitive discounts. It also serves as the primary mechanism for accumulating Protocol-Owned Liquidity (POL), which will be used to establish deep liquidity for the foundational $TAIKO/$TD pair on the Taikodrome DEX.


@jordaniza
jordaniza / TAIKODROME.spec.md
Last active September 16, 2025 14:48
Taikodrome Specification - Central Architecture Reference

Taikodrome Ideas Spec

Overview

Taikodrome is a fork of Aerodrome designed to bootstrap a new DEX economy on Taiko using $TAIKO as the exogenous token. This specification serves as the central reference for all architectural decisions and modifications required.

System Architecture

image
@jordaniza
jordaniza / TWAP-Liquidity-Bootstrap-Strategy.md
Last active September 16, 2025 14:55
TAIKO/TD Liquidity Bootstrap & TWAP Transition Strategy - Leveraging arbitrage for price discovery

TWAP Bootstrap Strategy for Taikodrome

What is TWAP?

TWAP (Time-Weighted Average Price) is a price calculation that averages the price of an asset over a specific time period, making it resistant to manipulation.

How TWAP Works in Aerodrome

Aerodrome pools store price observations at regular intervals (every 30 minutes by default):

  • Each observation records: timestamp, cumulative price
@jordaniza
jordaniza / ERC20Votes-Delegation-Liquidity-Pools-Analysis.md
Last active September 15, 2025 16:30
ERC20Votes TAIKO Delegation in Aerodrome Pools - Simple delegateTaiko() Solution

ERC20Votes Auto-Delegation for TAIKO in Aerodrome Pools

Executive Summary

This document analyzes the implementation of TAIKO token delegation in Aerodrome liquidity pools to prevent "dead" governance tokens from accumulating in the DEX. The solution is elegantly simple: have pools delegate to a multisig once, and all future TAIKO deposits automatically contribute voting power.

How ERC20Votes Delegation Works

The Key Mechanism

@jordaniza
jordaniza / Exogenous-Token-Integration-Considerations.md
Created September 15, 2025 16:02
Considerations for Injecting an Exogenous Token into Aerodrome

Considerations for Injecting an Exogenous Token into Aerodrome

Executive Summary

Replacing the native AERO token with an exogenous token in Aerodrome is technically feasible due to the protocol's modular architecture. However, this integration requires careful consideration of interface compatibility, minting mechanisms, governance implications, and economic effects. This document provides a comprehensive analysis of all considerations for such an integration.

Technical Requirements

1. Interface Compatibility

@jordaniza
jordaniza / AERO-Token-Minting-Deep-Dive.md
Last active October 24, 2025 12:01
AERO Token: Complete Tokenomics, Minting, and Rebase Analysis

AERO Token: Complete Tokenomics and Minting Analysis

Executive Summary

The AERO token implements a sophisticated emission system designed to bootstrap liquidity while protecting long-term token holders through an anti-dilution "rebase" mechanism. The protocol transitions through growth, decay, and tail emission phases, with a unique feature that mints additional tokens specifically to compensate veNFT holders for dilution. This document provides a comprehensive analysis of the minting mechanics, emission schedule, and the rebase system.

Table of Contents

  1. Core Architecture
  2. Emission Schedule
@jordaniza
jordaniza / Aerodrome-TWAP-Oracle-Implementation-Guide.md
Created September 15, 2025 15:59
Aerodrome TWAP Oracle Implementation Guide - Comprehensive analysis of TWAP functionality and price oracle usage

Aerodrome TWAP Oracle Implementation Guide

Overview

Aerodrome implements a Time-Weighted Average Price (TWAP) oracle directly within its liquidity pool contracts, providing a decentralized and manipulation-resistant price feed mechanism. This document provides a comprehensive analysis of the TWAP functionality and how to reliably use Aero pools as price oracles.

TWAP Architecture

Core Data Structures