This repository is an official ATF-AI Adapter. The canonical governance framework, specifications, and documentation now live at agronetlabs/ATF-AI. This repository implements the ATF-AI trust model on Ethereum-compatible networks.

erc-8040-ecosystem

ERC-8040 Compliance Token Standard - ESG & DeFi

Built on ATF-AI

This repository is an official ATF-AI adapter for blockchain-based ESG compliance.

ATF-AI (Autonomous Trust Framework for Artificial Intelligence) is the parent governance framework that provides verifiable provenance, deterministic validation, and zero-trust agent coordination for any infrastructure.

Role	Repository	Description
Parent Framework	agronetlabs/ATF-AI	Governance, provenance specs, zero-trust model
Blockchain Adapter	This repository	ERC-8040 implementation on EVM networks
Adapter Spec	ATF-AI/specs/adapters/erc8040.md	Formal adapter specification

The ERC-8040 standard implements the ATF-AI trust model on Ethereum-compatible networks, enabling ESG-scored tokens to carry cryptographic provenance and governance attestations defined by the ATF-AI protocol.

Canonical Documentation

The full technical documentation for this adapter is maintained in the ATF-AI repository:

• Blockchain Integration Overview
• Adapter Architecture
• SWIFT/ISO 20022 Bridge
• ERC-8040 Adapter Spec

ISO 20022 SWIFT Integration

ERC-8040 is the FIRST ESG token standard with native SWIFT ISO 20022 support, enabling seamless integration between blockchain-based ESG compliance tokens and traditional financial infrastructure.

Key Features

• Native ISO 20022 support for securities trading messages (SETR)
• SFDR compliance mapping (Articles 6, 8, 9) for EU regulatory requirements
• EU Taxonomy alignment calculation and reporting
• Carbon intensity estimation based on environmental scores
• Multi-language SDK support: Python, Rust, C++

Architecture Overview

            
  ERC-8040 Token   ISO 20022         SWIFT Network  
  ESG Scores             Bridge                  Financial Inst 
            
     Blockchain              Transformation           Traditional Finance

The ISO 20022 bridge automatically:

1. Converts ESG scores to ISO 20022 classifications
2. Maps ratings to SFDR articles (AAA/AA/A 9, BBB/BB 8, others 6)
3. Calculates EU Taxonomy alignment from environmental scores
4. Generates compliant SETR messages with embedded ESG metadata

Quick Example

from erc8040_sdk import ESGScore, ISO20022Bridge, FinancialInstrument

# Create ESG score
score = ESGScore.create(environmental=90.0, social=85.0, governance=80.0)

# Convert to ISO 20022
bridge = ISO20022Bridge()
classification = bridge.esg_to_iso(score)

# Generate SWIFT message
instrument = FinancialInstrument(
    isin="US46434G1031",
    lei="549300PZDW6EBUUJ8G35",
    name="ERC8040 Green Bond"
)
xml_message = bridge.create_setr_message(instrument, classification)

Documentation

• Integration Overview
• Architecture Details
• SWIFT Bridge Guide
• ISO 20022 Field Mapping
• Example SETR Message

Overview

As an ATF-AI adapter, this ecosystem extends the Autonomous Trust Framework for Artificial Intelligence with blockchain-native ESG compliance capabilities. This repository provides a core Rust library and SDKs for ESG scoring, regulatory compliance validation, and ISO 20022 integration.

Structure

• core/: Rust core library (ESG, compliance, ISO 20022, oracle)
• python-sdk/: Python SDK built on Pydantic
• cpp-sdk/: C++17 SDK for high-performance environments

Notes

• ESG weights are validated: non-negative and sum > 0.