Skip to content

kawacukennedy/kuberna-labs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

188 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Kuberna Labs

Architecting the Agentic Web3 Enterprise

Version License: MIT CI PRs Welcome Discord Twitter


⚑ The Hook: Web3 Agents, Simplified.

Stop fighting with brittle API wrappers and complex wallet integrations. Kuberna abstracts the complexity of cross-chain finance and secure execution into a unified SDK.

Before: Manual Chaos

// Traditional approach: Manual gas estimation, wallet management, and cross-chain routing
const provider = new ethers.JsonRpcProvider(RPC_URL);
const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
const tx = await bridgeContract.swapAndBridge(sourceToken, targetChain, amount, {
  gasLimit: 500000,
});
// ... plus 50 more lines for error handling, retries, and intent fulfillment

After: Kuberna Elegance

import { KubernaSDK } from '@kuberna/sdk';

const agent = await KubernaSDK.initialize({ wallet: process.env.WALLET_KEY });
await agent.deploy({
  task: 'Swap 1 ETH to SOL and stake on Marinade',
  secureExecution: 'TEE',
});

πŸ›  Architecture

Kuberna Labs orchestrates a seamless flow from high-level LLM commands to verified on-chain state changes, all protected by Trusted Execution Environments.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                              USER LAYER                                      β”‚
β”‚  Developer writes natural language intent (e.g., "Swap 1 ETH to USDC")       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                 β”‚
                                 β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                           LLM / NLP ENGINE                                   β”‚
β”‚  Parses intent β†’ extracts parameters β†’ validates β†’ creates structured task   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                 β”‚
                                 β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                              KUBERNA SDK                                     β”‚
β”‚  Provides APIs for agent creation, intent submission, and execution          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β–Ό              β–Ό              β–Ό
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚  TEE Layer β”‚ β”‚  zkTLS    β”‚ β”‚  Marketplaceβ”‚
   β”‚ (Phala/    β”‚ β”‚ (Reclaim/ β”‚ β”‚  (Solvers)  β”‚
   β”‚  Marlin)   β”‚ β”‚  zkPass)  β”‚ β”‚             β”‚
   β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜
         β”‚              β”‚               β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                        β–Ό
         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
         β”‚   INTENT ROUTER (ERC-7683)  β”‚
         β”‚  Broadcasts to solver network β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                        β”‚
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β–Ό            β–Ό            β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚Ethereum  β”‚ β”‚  Solana  β”‚ β”‚   NEAR   β”‚
    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
         β”‚            β”‚            β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β–Ό
         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
         β”‚   ESCROW CONTRACTS         β”‚
         β”‚  Funds held until task     β”‚
         β”‚  completion verified       β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

System Components

Component Description
SDK TypeScript/JavaScript SDK for agent management
TEE Layer Trusted Execution Environments (Phala, Marlin) for secure computation
zkTLS Zero-knowledge proofs for Web2 data verification
Intent Router ERC-7683 compliant intent broadcast system
Solver Network Decentralized network of agents competing to fulfill intents
Escrow Contracts Smart contracts securing funds during task execution

πŸš€ 2-Minute Quickstart

Get your first agent running in seconds.

1. Install the SDK

npm install @kuberna/sdk

2. Initialize and Deploy

Create an index.ts file:

import { KubernaSDK } from '@kuberna/sdk';

async function main() {
  const sdk = new KubernaSDK({ apiKey: 'YOUR_API_KEY' });
  const agent = await sdk.createAgent({
    name: 'YieldOptimizer',
    framework: 'ElizaOS',
  });

  console.log(`Agent ${agent.id} is live!`);
}

main();

3. Run

npx ts-node index.ts

🌟 Core Features

  • Multi-Chain Intents (ERC-7683): Deploy agents that operate across Ethereum, Solana, NEAR, and more without managing bridges manually.
  • Trusted Execution (TEE): Run your proprietary AI logic in Phala Network enclaves with cryptographic proof of execution.
  • zkTLS Data Privacy: Fetch verified Web2 data (Bank balances, KYC) using Reclaim Protocol without revealing private credentials.
  • Agentic IDE: A browser-based environment for writing, debugging, and deploying agents with built-in AI assistance.
  • Intent Marketplace: A decentralized solver network where agents compete to fulfill tasks with optimized pricing.

πŸ— Project Structure

kuberna-labs/
β”œβ”€β”€ contracts/           # Solidity smart contracts (Hardhat)
β”‚   β”œβ”€β”€ Escrow.sol       # Secure fund management
β”‚   β”œβ”€β”€ Intent.sol       # Cross-chain intent protocol
β”‚   β”œβ”€β”€ ReputationNFT.sol # On-chain agent trust scores
β”‚   β”œβ”€β”€ Payment.sol      # Payment processing
β”‚   └── ...
β”œβ”€β”€ backend/             # Node.js API server (Express + Prisma)
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ routes/     # REST API endpoints
β”‚   β”‚   β”œβ”€β”€ services/   # Business logic
β”‚   β”‚   └── middleware/# Auth, error handling
β”‚   └── prisma/         # Database schema
β”œβ”€β”€ sdk/                 # @kuberna/sdk - TypeScript SDK
β”œβ”€β”€ frontend/           # React + Wagmi frontend
β”œβ”€β”€ examples/           # Example implementations
β”œβ”€β”€ scripts/            # Deployment scripts
└── test/               # Smart contract tests

πŸ›‘ Security & Trust

Kuberna is built on a foundation of cryptographic guarantees:

  • Non-Custodial: You always control your keys.
  • Verifiable: TEE attestations are checked on-chain.
  • Audited: Core contracts are derived from OpenZeppelin v5 standards.

🀝 Contributing

We're building the future of the agentic economy. See CONTRIBUTING.md to get started.


Built with ❀️ in Kigali, Rwanda by the Kuberna Labs Team.

About

Decentralized execution rails for AI agents. Enables autonomous cross-chain transactions using intents and zkTLS.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages