🙌Developer Material

Welcome to the Developer Material hub for AERIS AI. This section provides everything you need to integrate, extend, and build on top of the AERIS AI Agent Market on Binance Smart Chain (BSC).

---

📦 1. SDKs & Client Libraries

We offer ready-to-use SDKs in your favorite languages, so you can focus on building AI-powered features instead of plumbing:

Language	Package Name	Install
JavaScript	@aeris/agent-sdk	npm install @aeris/agent-sdk
TypeScript	@aeris/agent-sdk	npm install @aeris/agent-sdk
Python	aeris_agent_sdk	pip install aeris-agent-sdk
Go	github.com/aeris/agent-sdk-go	go get github.com/aeris/agent-sdk-go

Each SDK wraps our JSON-RPC endpoints, smart-contract calls, and IPFS pinning flows into simple, promise-based methods.

---

🔗 2. Core API Endpoints

All endpoints are served via our public gateway at https://api.aeris.ai/v1. Requests use standard REST conventions and respond in JSON.

Endpoint	Method	Description
/agents	GET	List all deployed Agents with metadata and stats
/agents/{agentId}	GET	Fetch detailed configuration of a single Agent
/agents/{agentId}/invoke	POST	Send an inference request to your Agent
/agents/{agentId}/transactions	GET	Retrieve on-chain transaction history for an Agent
/tokens/{tokenSymbol}/price	GET	Real-time market price for a given Agent token
/users/{walletAddress}/agents	GET	List Agents owned or co-owned by a wallet

Authentication

• Public read endpoints require no key.

• Write operations (deploy, update, etc.) require an API key.

• Obtain your key in the Settings → API Keys section of the AERIS Dashboard (coming soon).

---

🎛️ 3. Smart-Contract Interfaces

All core contracts are deployed on BSC Mainnet. You can interact directly using any web3 library.

Contract	Address (BSC)	ABI Reference
AgentFactory	0xAER1sFacT0Ry000000000000	AgentFactory.json
AgentToken (BEP-20)	0xAER1sT0k3n00000000000000	AgentToken.json
BondingCurve	0xAER1sBondC0urvE0000000000	BondingCurve.json
MarketManager	0xAER1sM4rk3tM4n0g3r00000000	MarketManager.json

Example: Deploy an Agent

javascript import { AgentSDK } from '@aeris/agent-sdk';
const sdk = new AgentSDK({  
  rpcUrl: 'https://bsc-dataseed.binance.org/',  
  apiKey: 'YOUR_API_KEY'  
});

// 1. Define metadata
const metadata = {
  name: 'Cosmos',
  description: 'Science-focused AI Agent',
  personality: ['curious', 'empathetic', 'insightful'],
  framework: 'Sona',
  llm: 'ChatGPT'
};

// 2. Deploy
const receipt = await sdk.deployAgent({
  metadata,
  feeToken: 'AERIS',
  feeAmount: '100',
});
console.log('Agent deployed at:', receipt.contractAddress);

---

🛰️ 4. IPFS & Metadata

• All Agent metadata (JSON schema) and example prompts are stored on IPFS.

• Our SDK handles pinning and retrieving content automatically.

• Metadata schema is available in the repo: schemas/agent-metadata.json.

jsonc{
  "name": "string",
  "description": "string",
  "personality": ["string"],
  "framework": "string",
  "llm": "string",
  "examplePrompts": [
    {
      "input": "string",
      "output": "string"
    }
  ]
}

---

🔐 5. Security & Audits

• Audit Firms: CertiK, PeckShield

• Audit Reports:

  • AgentFactory & BondingCurve → completed Q2 2025

  • MarketManager → pending Q3 2025

We recommend integrating on-chain monitoring tools (Tenderly, BSCScan alerts) to track unusual activity and ensure peace of mind.

---

🗺️ 6. Roadmap & Contributions

• v1.0: Core contracts, SDKs, Market UI

• v1.1: API Key management, advanced analytics

• v2.0: DAO governance module, community proposals

• v2.1: Cross-chain support (Ethereum, Polygon)

Contributing

1. Fork our GitHub repo

2. Create feature branch (git checkout -b feature/awesome)

3. Commit your changes (git commit -m 'Add new feature')

4. Push to the branch (git push origin feature/awesome)

5. Open a Pull Request

We welcome bug reports, feature requests, and improvements. Join our community channels (links TBD) to collaborate!