# 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): What is BLOK Capital? BLOK Capital lets you grow your crypto wealth without ever giving up control. You can follow professionally selected crypto indices… - [Glossary](https://docs.blokcapital.io/en/concepts/glossary/glossary.md): Core Architecture (Diamond Pattern / EIP-2535) Term Definition ------ ----------- Diamond The main upgradeable proxy contract (Garden) that routes… - [Index Garden](https://docs.blokcapital.io/en/concepts/index-garden/index-garden.md): Garden Protocol: Architecture Overview --- Garden Creation Every garden is deployed through the Garden Factory no exceptions. Direct deployment is not… - [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… - [Diamond](https://docs.blokcapital.io/en/concepts/protocol-concepts/diamond.md): Diamond Architecture Overview The Diamond architecture is a modular smart contract system designed for long-lived, evolving protocols. At its core, a… - [ERC’s & EIP’s](https://docs.blokcapital.io/en/concepts/protocol-concepts/ercs-and-eips.md): Which ERCs and EIPs back the protocol? - ERC-20 – Standard for fungible tokens, ensuring your assets work everywhere in DeFi. - ERC-165 – Interface… - [Proxy Contracts](https://docs.blokcapital.io/en/concepts/protocol-concepts/proxy-contracts.md): Proxy Contracts Explained A proxy contract is a way to upgrade a smart contract system without changing the address users interact with. Instead of… - [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. It treats the protocol's total liquidity as one pooled amount and moves it together… - [Wealth Management](https://docs.blokcapital.io/en/concepts/protocol-concepts/wealth-management.md): Introduction Decentralized wealth management solves a long-standing problem in investing: getting structured portfolio management without giving up… - [User Journey](https://docs.blokcapital.io/en/concepts/user-journey.md): Sign in and create your smart wallet - Sign in with Google. - Create your smart wallet account (SWA). This is the account that will hold your assets and… ## 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): Entry Point: The Diamond Controller ( ) File: This is the main controller contract and the only contract address that end‑users and most integrations… - [Facet Registry](https://docs.blokcapital.io/en/smart-contracts/facet-registry.md): Facet Registry (Governance & Approval Layer) Location: Key files: - — Manages facet registration and version tracking - — Public interface --- What It… - [Facet Architecture](https://docs.blokcapital.io/en/smart-contracts/facets.md): Facet Architecture (Grouped by Responsibility) The facets are split into two main groups: 1. Base facets – the core of the Diamond. 2. Feature facets –… - [Indices Layer](https://docs.blokcapital.io/en/smart-contracts/indices-layer.md): Indices Layer (Domain & Business Logic) Location: Key components: - : Core index contract managing components and weights. - : Factory for deploying Index… - [Infrastructure & Storage](https://docs.blokcapital.io/en/smart-contracts/infrastructure.md): 5 Storage & State Management Diamond’s power comes with one big constraint: all facets share storage . To manage that safely, this repo uses storage… - [Introduction & Builder's Guide](https://docs.blokcapital.io/en/smart-contracts/introduction.md): System Overview This repository implements an on‑chain asset management protocol built around a Diamond (EIP‑2535) controller called the Garden . High… ## 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): Overview 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,… - [Smart contract style guide](https://docs.blokcapital.io/en/builders/Guides/contract-style-guide.md): Naming conventions 1. Architectural Overview Our protocol uses a modular diamond/facet architecture, where each facet encapsulates a specific domain… - [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. This is the internal engine for… - [Loupe](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/base-facets/loupe.md): The Loupe module is entirely read-only. It provides the introspection functions required by EIP-2535, allowing block explorers, frontends, and indexing… - [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… - [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,… - [Facet.sol](https://docs.blokcapital.io/en/builders/blok-c-v1-core/garden/facets/facet.md): Access Layer: - acts as the base contract for all logic modules in the Garden. - It defines the core access control rules that every module follows. - Its… - [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. Core… - [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. Core… - [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. Main Focus:… - [Protocol Architecture V1](https://docs.blokcapital.io/en/builders/blok-capital-v1.md): The core parts of our architecture is as follows : Wallet Infrastructure Onboarding new users is hindered by the complexity and risk of seed-phrase… - [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. By… - [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… - [Gardens & Diamonds](https://docs.blokcapital.io/en/builders/smart-contracts/gardens-and-diamonds.md): The Architecture of Diamonds & Gardens At BLOK Capital, our main architecture for the smart contracts depends on the Diamond proxy pattern. In this… - [Overview](https://docs.blokcapital.io/en/builders/smart-contracts/overview.md): Gardens Gardens are programmable crypto portfolios implemented as ERC-2535 Diamond contracts. Each Garden acts as a smart “hub” for a user’s investments,… - [Why Transparent proxy standard for Factory and Registries?](https://docs.blokcapital.io/en/builders/smart-contracts/transparent-proxy.md): ERC-1967: Preventing Storage Collisions The Transparent Proxy implementation follows EIP-1967, which standardizes how proxies store the implementation… ## 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): Frequently asked questions about BLOK Capital. - [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… - [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… - [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… - [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. Each color has been… - [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. It features a custom-designed symbol paired with a distinctive logotype, crafted… - [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. Whether you're a developer, designer, or community member, your input helps… - [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… - [Resources Section](https://docs.blokcapital.io/en/resources/intro.md): The Resources Section provides essential materials and references for users, developers, and contributors. It includes security audits, brand usage… - [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.