@daohost/host 0.8.0

package/README.md

@@ -0,0 +1,39 @@
+# DAO.Host: Where True DAOs Live & Work
+
+![GitHub Tag](https://img.shields.io/github/v/tag/stabilitydao/host)
+![NPM Version](https://img.shields.io/npm/v/%40stabilitydao%2Fhost?label=NPM%20version)
+
+![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/stabilitydao/host?label=code%20size)
+![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/%40stabilitydao%2Fhost?label=NPM%20unpacked%20size)
+
+<p align="left">
+<a href="https://dao.host">
+<img src="/logo.png" title="Infrastructure layer for strategic DeFi Assets Management">
+</a>
+</p>
+
+Unit Status: **BUILDING_PROTOTYPE**
+
+**Host** is an Operating System of Self-developing Decentralized Autonomous Organizations.
+
+This repository contains the core Host integration library and its typescript implementation.
+
+## Use in project
+
+```shell
+yarn add @stabilitydao/host
+```
+
+## Tools
+
+```shell
+yarn overview
+yarn draw:dao
+```
+
+## Develop
+
+```shell
+yarn coverage
+yarn prettier --write .
+```

package/out/activity.d.ts

@@ -0,0 +1,16 @@
+import { UnitType } from "./host/types";
+/** Organization activities supported by OS. */
+export declare enum Activity {
+    /** Owner of Decentralized Finance protocols */
+    DEFI = "DEFI",
+    /** Owner of Maximum Extractable Value tools */
+    MEV = "MEV"
+}
+export declare const activities: {
+    [activity in Activity]: {
+        title: string;
+        unitTypes: UnitType[];
+        description?: string;
+    };
+};
+//# sourceMappingURL=activity.d.ts.map

package/out/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,+CAA+C;AAC/C,oBAAY,QAAQ;IAClB,+CAA+C;IAC/C,IAAI,SAAS;IACb,+CAA+C;IAC/C,GAAG,QAAQ;CAGZ;AAED,eAAO,MAAM,UAAU,EAAE;KACtB,QAAQ,IAAI,QAAQ,GAAG;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;CAUF,CAAC"}

package/out/activity.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activities = exports.Activity = void 0;
+const types_1 = require("./host/types");
+/** Organization activities supported by OS. */
+var Activity;
+(function (Activity) {
+    /** Owner of Decentralized Finance protocols */
+    Activity["DEFI"] = "DEFI";
+    /** Owner of Maximum Extractable Value tools */
+    Activity["MEV"] = "MEV";
+    /** Owner of Software as a Service business */
+    //SAAS_OPERATOR = "SAAS_OPERATOR",
+})(Activity || (exports.Activity = Activity = {}));
+exports.activities = {
+    [Activity.DEFI]: {
+        title: "Decentralized Finance Protocol Operator",
+        unitTypes: [types_1.UnitType.DEFI_PROTOCOL],
+    },
+    [Activity.MEV]: {
+        title: "Maximum Extractable Value tools",
+        unitTypes: [types_1.UnitType.MEV_SEARCHER],
+    },
+};
+//# sourceMappingURL=activity.js.map

package/out/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":";;;AAAA,wCAAwC;AAExC,+CAA+C;AAC/C,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,+CAA+C;IAC/C,yBAAa,CAAA;IACb,+CAA+C;IAC/C,uBAAW,CAAA;IACX,8CAA8C;IAC9C,kCAAkC;AACpC,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB;AAEY,QAAA,UAAU,GAMnB;IACF,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACf,KAAK,EAAE,yCAAyC;QAChD,SAAS,EAAE,CAAC,gBAAQ,CAAC,aAAa,CAAC;KACpC;IACD,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACd,KAAK,EAAE,iCAAiC;QACxC,SAAS,EAAE,CAAC,gBAAQ,CAAC,YAAY,CAAC;KACnC;CACF,CAAC"}

package/out/agents.d.ts

@@ -0,0 +1,15 @@
+export interface IAgent {
+    api: string[];
+    roles: AgentRole[];
+    name: string;
+    unitIds: string[];
+    directives?: string[];
+    image?: string;
+    telegram?: `@${string}`;
+}
+export declare const enum AgentRole {
+    API_OPERATOR = "API_OPERATOR",
+    TX_SENDER = "TX_SENDER",
+    MEV_SEARCHER = "MEV_SEARCHER"
+}
+//# sourceMappingURL=agents.d.ts.map

package/out/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;CACzB;AAED,0BAAkB,SAAS;IACzB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B"}

package/out/agents.js

@@ -0,0 +1,14 @@
+"use strict";
+/*
+ * Agent is highly abstract and high-level entity that follow role directives.
+ * Agents are owned by DAOs built on Host.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRole = void 0;
+var AgentRole;
+(function (AgentRole) {
+    AgentRole["API_OPERATOR"] = "API_OPERATOR";
+    AgentRole["TX_SENDER"] = "TX_SENDER";
+    AgentRole["MEV_SEARCHER"] = "MEV_SEARCHER";
+})(AgentRole || (exports.AgentRole = AgentRole = {}));
+//# sourceMappingURL=agents.js.map

package/out/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAYH,IAAkB,SAIjB;AAJD,WAAkB,SAAS;IACzB,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;IACvB,0CAA6B,CAAA;AAC/B,CAAC,EAJiB,SAAS,yBAAT,SAAS,QAI1B"}

package/out/api.d.ts

@@ -0,0 +1,115 @@
+import { IGithubIssueV2, IGithubUser } from "./unit";
+export interface IAgentMemory {
+    /** When generated */
+    timestamp: number;
+    /** Private memory data allow to show only overview by agent API */
+    private: boolean;
+    /** Memory data overview */
+    overview: {
+        [title: string]: string;
+    };
+    /** Timestamp when agent instance launched */
+    started: number;
+    /** EVM transaction sender */
+    txSender?: {
+        /** EOA */
+        account: `0x${string}`;
+        /** Coin balances */
+        balance: {
+            [chainId: string]: {
+                coin: string;
+                usd: number;
+            };
+        };
+        /** Spent for gas */
+        spent: {
+            [date: string]: {
+                txs: number;
+                usd: {
+                    [chainId: string]: number;
+                };
+            };
+        };
+    };
+    /** Data specific for agent */
+    data: any;
+}
+export interface IHostAgentMemoryV3 extends IAgentMemory {
+    data: {
+        /** Prices of assets */
+        prices: Prices;
+        /** Total Value Locked in blockchains */
+        chainTvl: {
+            [chainId: string]: number;
+        };
+        /** DAO runtime data. Updates each minute or faster. */
+        daos: {
+            [symbol: string]: IDAOAPIDataV2;
+        };
+        /** Instant Updates by subscribing to github application webhooks */
+        builders: IBuildersMemoryV3;
+    };
+}
+export interface IDAOAPIDataV2 {
+    /** Price from Stability interchain oracle */
+    oraclePrice: string;
+    /** Coingecko price */
+    coingeckoPrice?: string;
+    /** Data for total revenue chart */
+    revenueChart: RevenueChart;
+    /** Extracted on-chain data */
+    onChainData: {
+        [chainId: string]: {
+            stakingAPR: number;
+            staked: number;
+            units: {
+                [unitId: string]: {
+                    pendingRevenueUSD: number;
+                    pendingRevenueAssetAmount: number;
+                    pendingRevenueAssetSymbol: string;
+                    pendingRevenueAssetAddress?: string;
+                }[];
+            };
+            revenueTokens?: `0x${string}`[];
+        };
+    };
+    /** Users / followers in tracked socials */
+    socialUsers: {
+        [socialLink: string]: number;
+    };
+    holders?: IDAOHolders;
+}
+export interface IDAOHolders {
+    [addr: string]: IDAOHoldings;
+}
+export interface IDAOHoldings {
+    address: `0x${string}`;
+    balance: string;
+    percentage?: string;
+}
+export type Prices = {
+    [symbol: string]: {
+        priceUsd: string;
+        priceChange: number;
+    };
+};
+export type RevenueChart = Record<number, string>;
+/**
+ DAO can build by installing Host Agent GitHub App and emitting `IUnitPool` by pool key of `IUnitEmitData`
+ */
+export interface IBuildersMemoryV3 {
+    [tokenSymbol: string]: {
+        openIssues: {
+            [unitId: string]: IGithubIssueV2[];
+        };
+        repos: {
+            [repo: string]: {
+                openIssues: number;
+                private: boolean;
+                access?: IGithubUser[];
+                stars?: number;
+            };
+        };
+    };
+}
+//# sourceMappingURL=api.d.ts.map

package/out/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/out/api.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/out/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}

package/out/assets.d.ts

@@ -0,0 +1,46 @@
+export type Asset = {
+    addresses: {
+        [chainId: string]: `0x${string}` | `0x${string}`[];
+    };
+    symbol: string;
+    description?: string;
+    website: string;
+    color?: string;
+    mintApp?: string;
+};
+export declare const assets: Asset[];
+export declare const getAsset: (chainId: string, tokenAddress: `0x${string}`) => Asset | undefined;
+export declare function getAssetBySymbol(symbol: string): Asset | undefined;
+export type TokenData = {
+    address: `0x${string}`;
+    name: string;
+    symbol: string;
+    chainId: number;
+    decimals: number;
+    logoURI: string;
+    tags?: string[];
+};
+/**
+ * Function to get token data from token list
+ *
+ * @example
+ *
+ * ```
+ * getTokenData("146", "0x2791bca1f2de4661ed88a30c99a7a9449aa84174")
+ * ```
+ *
+ * @param chainId - Chain ID string
+ * @param address - Token address
+ *
+ * @returns {Object} Token Information
+ * @property {`0x${string}`} address - Token contract address
+ * @property {number} chainId - ID of the blockchain network (e.g., 137 for Polygon)
+ * @property {number} decimals - Number of decimals the token uses
+ * @property {string} name - Full name of the token (e.g., "Dai Stablecoin").
+ * @property {string} symbol - Token ticker symbol (e.g., "DAI").
+ * @property {string} logoURI - URL of the token's logo image.
+ * @property {string[]} tags - Array of tags related to the token (e.g., ["stablecoin", "DeFi"]).
+ *
+ **/
+export declare const getTokenData: (chainId: string, address: `0x${string}`) => TokenData | undefined;
+//# sourceMappingURL=assets.d.ts.map

package/out/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,KAAK,GAAG;IAClB,SAAS,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE,EAAE,CAAA;KAAE,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAAK,EA0lDzB,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,SAAS,MAAM,EACf,cAAc,KAAK,MAAM,EAAE,KAC1B,KAAK,GAAG,SAkBV,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAMlE;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;IAqBI;AACJ,eAAO,MAAM,YAAY,GACvB,SAAS,MAAM,EACf,SAAS,KAAK,MAAM,EAAE,KACrB,SAAS,GAAG,SAkBd,CAAC"}