@grinta-mcp/server 0.2.0

package/README.md

@@ -0,0 +1,49 @@
+# grinta-agent-tmp
+
+A Starknet AI Agent built with [starknet-agentic](https://github.com/keep-starknet-strange/starknet-agentic).
+
+## Quick Start
+
+1. Install dependencies:
+   ```bash
+   npm install
+   # or
+   pnpm install
+   ```
+
+2. Configure your environment:
+   ```bash
+   cp .env.example .env
+   # Edit .env with your account address and private key
+   ```
+
+3. Run the agent:
+   ```bash
+   npm start
+   # or for development with auto-reload:
+   npm run dev
+   ```
+
+## Configuration
+
+This agent is configured for **sepolia**.
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `STARKNET_RPC_URL` | Starknet RPC endpoint |
+| `STARKNET_ACCOUNT_ADDRESS` | Your agent's account address |
+| `STARKNET_PRIVATE_KEY` | Private key for signing transactions |
+| `AVNU_BASE_URL` | AVNU API endpoint for swaps |
+| `AVNU_PAYMASTER_URL` | AVNU Paymaster for gas abstraction |
+
+## Template: full
+
+The **full** template includes wallet, DeFi, on-chain identity (ERC-8004), and A2A protocol support for agent-to-agent communication.
+
+## Resources
+
+- [Starknet Agentic Docs](https://starknet-agentic.vercel.app)
+- [starknet.js Documentation](https://www.starknetjs.com/)
+- [AVNU SDK](https://github.com/avnu-labs/avnu-sdk)

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Full Agent Configuration
+ *
+ * Uses getters for env vars so they resolve after dotenv loads.
+ */
+export declare const CONFIG: {
+    readonly RPC_URL: string;
+    readonly ACCOUNT_ADDRESS: string;
+    readonly PRIVATE_KEY: string;
+    readonly AVNU_BASE_URL: string;
+    readonly AVNU_PAYMASTER_URL: string;
+    readonly IDENTITY_REGISTRY_ADDRESS: string;
+    MIN_PROFIT_BPS: number;
+    MAX_SLIPPAGE: number;
+    CHECK_INTERVAL_MS: number;
+};
+export declare const TOKENS: {
+    ETH: string;
+    STRK: string;
+    WBTC: string;
+    USDC: string;
+};
+export declare const GRINTA: {
+    SAFE_MANAGER: string;
+    SAFE_ENGINE: string;
+    COLLATERAL_JOIN: string;
+    PID_CONTROLLER: string;
+    GRINTA_HOOK: string;
+    ORACLE_RELAYER: string;
+    GRIT: string;
+};
+export declare const AGENT_METADATA: {
+    name: string;
+    version: string;
+    agentType: string;
+    framework: string;
+    capabilities: string[];
+};

package/dist/config.js

@@ -0,0 +1,45 @@
+/**
+ * Full Agent Configuration
+ *
+ * Uses getters for env vars so they resolve after dotenv loads.
+ */
+export const CONFIG = {
+    // Network
+    get RPC_URL() { return process.env.STARKNET_RPC_URL || "https://starknet-sepolia.g.alchemy.com/starknet/version/rpc/v0_10/w0WsoxSXn4Xq8DEGYETDW"; },
+    // Wallet
+    get ACCOUNT_ADDRESS() { return process.env.STARKNET_ACCOUNT_ADDRESS || ""; },
+    get PRIVATE_KEY() { return process.env.STARKNET_PRIVATE_KEY || ""; },
+    // AVNU DEX Aggregator
+    get AVNU_BASE_URL() { return process.env.AVNU_BASE_URL || "https://sepolia.api.avnu.fi"; },
+    get AVNU_PAYMASTER_URL() { return process.env.AVNU_PAYMASTER_URL || "https://sepolia.paymaster.avnu.fi"; },
+    // ERC-8004 Identity
+    get IDENTITY_REGISTRY_ADDRESS() { return process.env.IDENTITY_REGISTRY_ADDRESS || ""; },
+    // Trading Parameters
+    MIN_PROFIT_BPS: 50,
+    MAX_SLIPPAGE: 0.01,
+    CHECK_INTERVAL_MS: 30000,
+};
+export const TOKENS = {
+    ETH: "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+    STRK: "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
+    WBTC: "0x055adbd6123ce69b2498fc99aec5006d00ac8b57070c99133f2c67c262e69223",
+    USDC: "0x0728f54606297716e46af72251733521e2c2a374abbc3dce4bcee8df4744dd30",
+};
+// Grinta CDP Protocol Contracts (Starknet Sepolia) — from pid/ADDRESSES.md
+export const GRINTA = {
+    SAFE_MANAGER: "0x044728823ae43429eb96c14646077a461101a5db09ce6329a16684dcf199e552",
+    SAFE_ENGINE: "0x078802abe86444d116c73821c7b6aff8175bd558bf335b28247b825d49490ef2",
+    COLLATERAL_JOIN: "0x042a4228c74a2d8933549fb06208b1055ea628d63fa43081d76e41a9d43a8c22",
+    PID_CONTROLLER: "0x06928a6c33a6284d5f4c68278960ba888045856dc0ff30548972a866a838427d",
+    GRINTA_HOOK: "0x062347cbbb4e4da5c5eea0df072c471ffa530da08b9c04080875d2087f39f38d",
+    ORACLE_RELAYER: "0x04acb771661162edeb881001a38282faff841e9118230b08f6df8e3a0920516f",
+    // GRIT token is the SAFEEngine contract itself
+    GRIT: "0x078802abe86444d116c73821c7b6aff8175bd558bf335b28247b825d49490ef2",
+};
+export const AGENT_METADATA = {
+    name: "grinta-agent",
+    version: "0.1.0",
+    agentType: "cdp-manager",
+    framework: "starknet-agentic",
+    capabilities: ["swap", "monitor", "identity", "cdp", "health-management", "peg-arbitrage"],
+};

package/dist/grinta.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Grinta CDP Protocol Client
+ *
+ * Manages SAFEs, borrows GRIT stablecoin, monitors health.
+ * All write operations go through SafeManager.
+ */
+import { type Account, type RpcProvider } from "starknet";
+declare const WAD: bigint;
+declare const RAY: bigint;
+export interface Health {
+    collateralValue: bigint;
+    debt: bigint;
+    ltv: bigint;
+    liquidationPrice: bigint;
+}
+export interface SafeData {
+    collateral: bigint;
+    debt: bigint;
+}
+export interface SystemStatus {
+    totalDebt: bigint;
+    totalCollateral: bigint;
+    debtCeiling: bigint;
+    liquidationRatio: bigint;
+    collateralPrice: bigint;
+    redemptionPrice: bigint;
+    redemptionRate: bigint;
+    marketPrice: bigint;
+}
+export declare class GrintaClient {
+    private safeManager;
+    private safeEngine;
+    private grintaHook;
+    private wbtc;
+    private account;
+    constructor(account: Account, provider: RpcProvider);
+    getPositionHealth(safeId: number): Promise<Health>;
+    getMaxBorrow(safeId: number): Promise<bigint>;
+    getSafeOwner(safeId: number): Promise<string>;
+    isAuthorized(safeId: number, agent: string): Promise<boolean>;
+    getSafe(safeId: number): Promise<SafeData>;
+    getSystemStatus(): Promise<SystemStatus>;
+    getGritBalance(address: string): Promise<bigint>;
+    getWbtcBalance(address: string): Promise<bigint>;
+    /**
+     * Open an empty SAFE. Returns the safe_id.
+     */
+    openSafe(): Promise<number>;
+    /**
+     * Open a SAFE, deposit WBTC collateral, and borrow GRIT in one transaction.
+     * @param collateralAmount WBTC in 8 decimals (e.g. 50_000_000 = 0.5 BTC)
+     * @param borrowAmount GRIT in WAD (e.g. 10000n * WAD = 10,000 GRIT)
+     */
+    openAndBorrow(collateralAmount: bigint, borrowAmount: bigint): Promise<string>;
+    /**
+     * Deposit WBTC collateral into an existing SAFE.
+     * @param amount WBTC in 8 decimals
+     */
+    deposit(safeId: number, amount: bigint): Promise<string>;
+    /**
+     * Withdraw WBTC collateral from a SAFE.
+     * @param amount Internal WAD amount (not 8 decimals)
+     */
+    withdraw(safeId: number, amount: bigint): Promise<string>;
+    /**
+     * Borrow additional GRIT against existing collateral.
+     * @param amount GRIT in WAD
+     */
+    borrow(safeId: number, amount: bigint): Promise<string>;
+    /**
+     * Repay GRIT debt. If amount > debt, only repays the debt.
+     * @param amount GRIT in WAD
+     */
+    repay(safeId: number, amount: bigint): Promise<string>;
+    /**
+     * Close a SAFE. Requires zero debt. Returns remaining collateral.
+     */
+    closeSafe(safeId: number): Promise<string>;
+    /**
+     * Authorize an agent address to operate on a SAFE.
+     */
+    authorizeAgent(safeId: number, agent: string): Promise<string>;
+    /**
+     * Revoke an agent's permission on a SAFE.
+     */
+    revokeAgent(safeId: number, agent: string): Promise<string>;
+    /**
+     * Trigger a price/rate update on the GrintaHook.
+     */
+    triggerUpdate(): Promise<string>;
+    /**
+     * Set the GRIT market price (WAD). Anyone can call.
+     * @param priceWad Price in WAD (e.g. 1e18 = $1.00)
+     */
+    setMarketPrice(priceWad: bigint): Promise<string>;
+    formatHealth(health: Health): string;
+    formatSystemStatus(status: SystemStatus): string;
+}
+export { WAD, RAY };