# BLOK Capital Docs

> Official documentation for BLOK Capital, a non-custodial, on-chain wealth management protocol on EVM chains. Covers the Diamond (EIP-2535) architecture, account abstraction, Gardens, facets, oracles, the V1 smart-contract system, tokenomics, DAO governance, and builder guides.

This file helps AI assistants and answer engines discover and cite the BLOK Capital documentation. All pages are also available in Spanish (`/es/`) and French (`/fr/`).

## Concepts

- [Concepts overview](https://docs.blokcapital.io/en/concepts): Protocol fundamentals: account abstraction, Diamonds, oracles, and wealth management.
- [BLOK Capital Overview](https://docs.blokcapital.io/en/concepts/blok-c-overview.md): BLOK Capital lets you grow your crypto wealth without ever giving up control.
- [Glossary](https://docs.blokcapital.io/en/concepts/glossary/glossary.md): Core Architecture (Diamond Pattern / EIP-2535) · Garden & Factory · Index & Rebalancing · Protocol Governance & Status · DEX & Liquidity
- [Index Garden](https://docs.blokcapital.io/en/concepts/index-garden/index-garden.md): Every garden is deployed through the Garden Factory no exceptions. Direct deployment is not permitted.
- [Account Abstraction](https://docs.blokcapital.io/en/concepts/protocol-concepts/account-abstraction.md): Account Abstraction replaces the limitations of traditional Ethereum wallets with programmable smart contract wallets that control how transactions are authorized, executed, and paid for.
- [Diamond](https://docs.blokcapital.io/en/concepts/protocol-concepts/diamond.md): The Diamond architecture is a modular smart contract system designed for long-lived, evolving protocols.
- [ERC’s & EIP’s](https://docs.blokcapital.io/en/concepts/protocol-concepts/ercs-and-eips.md): ERC-20 – Standard for fungible tokens, ensuring your assets work everywhere in DeFi. ERC-165 – Interface detection, so contracts can communicate smoothly with each other.
- [Proxy Contracts](https://docs.blokcapital.io/en/concepts/protocol-concepts/proxy-contracts.md): A proxy contract is a way to upgrade a smart contract system without changing the address users interact with.
- [Rebalancer Network](https://docs.blokcapital.io/en/concepts/protocol-concepts/rebalancer-network.md): The Rebalancer is a single smart contract designed for highly efficient, gas-minimized index and yield management.
- [Wealth Management](https://docs.blokcapital.io/en/concepts/protocol-concepts/wealth-management.md): Decentralized wealth management solves a long-standing problem in investing: getting structured portfolio management without giving up control of your assets.
- [User Journey](https://docs.blokcapital.io/en/concepts/user-journey.md): Sign in with Google. Create your smart wallet account (SWA). This is the account that will hold your assets and interact with the protocol.

## Smart Contracts

- [Smart Contracts overview](https://docs.blokcapital.io/en/smart-contracts): The V1 on-chain architecture: entry points, facets, the registry, and indices.
- [The Diamond Controller](https://docs.blokcapital.io/en/smart-contracts/entry-point.md): This is the main controller contract and the only contract address that end‑users and most integrations should interact with.
- [Facet Registry](https://docs.blokcapital.io/en/smart-contracts/facet-registry.md): Key files: — Manages facet registration and version tracking — Public interface
- [Facet Architecture](https://docs.blokcapital.io/en/smart-contracts/facets.md): The facets are split into two main groups:
- [Indices Layer](https://docs.blokcapital.io/en/smart-contracts/indices-layer.md): Key components: Core index contract managing components and weights. Factory for deploying Index instances. Whitelist of approved tokens. Whitelist of approved calculation strategies.
- [Infrastructure & Storage](https://docs.blokcapital.io/en/smart-contracts/infrastructure.md): Diamond’s power comes with one big constraint: all facets share storage. To manage that safely, this repo uses storage libraries.
- [Introduction & Builder's Guide](https://docs.blokcapital.io/en/smart-contracts/introduction.md): This repository implements an on‑chain asset management protocol built around a Diamond (EIP‑2535) controller called the Garden.

## Builders

- [Builders overview](https://docs.blokcapital.io/en/builders): Hands-on guides for building on BLOK Capital: Gardens, facets, and governance.
- [Guide: Creating a New Diamond Facet](https://docs.blokcapital.io/en/builders/Guides/Facets.md): In this project we use the EIP-2535 “Diamond” pattern to compose modular contracts. A Diamond is a proxy that delegates calls to multiple Facets, each holding related logic.
- [Smart contract style guide](https://docs.blokcapital.io/en/builders/Guides/contract-style-guide.md): Our protocol uses a modular diamond/facet architecture, where each facet encapsulates a specific domain (e.g., Uniswap swaps, garden creation, access control).
- [Cut](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/base-facets/cut.md): This module manages state upgrades within the Diamond but enforces Blok Capital's strict "Registry-First" security model.
- [Loupe](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/base-facets/loupe.md): The Loupe module is entirely read-only.
- [Ownership](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/base-facets/ownership.md): The ownership module provides standard ERC-173 administrative control but stores the state securely within the Diamond Storage pattern to prevent collisions during upgrades.
- [Upgrade](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/base-facets/upgrade.md): As is blocked in the Base Facets, the Upgrade Module is the only authorized way to alter a Garden's logic. It relies on a deterministic, version-controlled sync with the global .
- [Facet.sol](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/facet.md): acts as the base contract for all logic modules in the Garden. It defines the core access control rules that every module follows.
- [Base.sol & Facet.sol](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/index-facets/base-and-facet.md): These files house the core business logic for portfolio rebalancing. The process is divided into two distinct transactions to guarantee security.
- [IIndex.sol](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/index-facets/i-index.md): This interface defines the essential data structures passed between the off-chain Centralized Relayer Engine (CRE) and the on-chain protocol.
- [IndexStorage.sol](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/index-facets/index-storage.md): As the Diamond pattern relies on , state must be carefully managed to avoid storage collisions. Blok Capital uses the Diamond Storage pattern.
- [Protocol Architecture V1](https://docs.blokcapital.io/en/builders/blok-capital-v1.md): Onboarding new users is hindered by the complexity and risk of seed-phrase management.
- [Governance with Aragon](https://docs.blokcapital.io/en/builders/dao-governance/blokc-proposal.md): At BLOK Capital, we’re redefining decentralized governance by building a robust and modular DAO proposal system, seamlessly powered by Aragon OSX.
- [Builders Section](https://docs.blokcapital.io/en/builders/intro.md): The Builders Section is designed for developers and technical contributors who want to dive deep into the architecture, smart contracts, and governance logic of the Blok Capital ecosystem.
- [Gardens & Diamonds](https://docs.blokcapital.io/en/builders/smart-contracts/gardens-and-diamonds.md): At BLOK Capital, our main architecture for the smart contracts depends on the Diamond proxy pattern.
- [Overview](https://docs.blokcapital.io/en/builders/smart-contracts/overview.md): Gardens are programmable crypto portfolios implemented as ERC-2535 Diamond contracts.
- [Why Transparent proxy standard for Factory and Registries?](https://docs.blokcapital.io/en/builders/smart-contracts/transparent-proxy.md): The Transparent Proxy implementation follows EIP-1967, which standardizes how proxies store the implementation contract address.

## Resources

- [Resources overview](https://docs.blokcapital.io/en/resources): Tokenomics, audits, FAQs, brand assets, and contract addresses.
- [FAQs](https://docs.blokcapital.io/en/resources/FAQs/FAQs.md): BLOK Capital enables investors to maintain full control of their crypto assets while allowing wealth managers(Gardeners) to manage these assets under predefined terms set via smart contracts.
- [Behavioural Economics](https://docs.blokcapital.io/en/resources/Tokenomics/behavioural-economics.md): The key market that the protocol is trying to serve is to connect professional medium and long term wealth managers with novice investors who are time poor and need professional help to try and…
- [The Token](https://docs.blokcapital.io/en/resources/Tokenomics/the-token.md): Key details of the BLOKC token—built on Arbitrum, designed for utility, governance, and long-term ecosystem alignment.
- [Token Utility](https://docs.blokcapital.io/en/resources/Tokenomics/token-utility.md): Our token will be used for the following: Governance of the Blok Capital Platform Medium of exchange on the platform between investors and wealth managers to handle payment of fees.
- [Tokenomics Chart](https://docs.blokcapital.io/en/resources/Tokenomics/tokenomics-chart.md): A visual breakdown of BLOKC's token distribution—designed to ensure long-term sustainability, alignment, and ecosystem growth.
- [Security Overview](https://docs.blokcapital.io/en/resources/audits-and-security/audits.md): At BLOK Capital, security isn’t just a feature, it’s our foundation. We are committed to ensuring that our smart contracts are as secure, reliable, and resilient as possible.
- [Color Palette](https://docs.blokcapital.io/en/resources/brand-guidelines/color-palette.md): At BLOK Capital, our color palette is carefully curated to reflect both our technological innovation and our community-first approach.
- [Logo Design](https://docs.blokcapital.io/en/resources/brand-guidelines/logo-design.md): The BLOK Capital logo is a foundational element of our visual identity.
- [Token Design](https://docs.blokcapital.io/en/resources/brand-guidelines/token-design.md): At BLOK Capital, our token transcends mere functionality—it embodies our commitment to decentralized wealth management and community-driven governance.
- [Contribute to our docs](https://docs.blokcapital.io/en/resources/create-video.md): BLOKC thrives on open contributions, and our documentation is no exception.
- [Garden Indices](https://docs.blokcapital.io/en/resources/garden-index.md): A market-cap weighted index assigns weights to assets proportional to their market capitalization relative to the total market capitalization of the portfolio (or basket).
- [Resources Section](https://docs.blokcapital.io/en/resources/intro.md): The Resources Section provides essential materials and references for users, developers, and contributors.
- [Smart Contract Addresses](https://docs.blokcapital.io/en/resources/smart-contract-address.md): The contracts are currently under development, this section would be live soon.

## Optional

- [Documentation home](https://docs.blokcapital.io/en): Start here — overview and the four documentation sections.
- [Website](https://blokcapital.io): The BLOK Capital product site.
- [Full documentation corpus](https://docs.blokcapital.io/llms-full.txt): Every page concatenated as Markdown.