alia-contracts-spec 0.1.0

package/dist/factories/adapters/index.d.ts

@@ -0,0 +1,10 @@
+export { IAaveV3BNBAdapter__factory } from "./IAaveV3BNBAdapter__factory";
+export { ICompoundAdapter__factory } from "./ICompoundAdapter__factory";
+export { IEulerAdapter__factory } from "./IEulerAdapter__factory";
+export { IKernelAdapter__factory } from "./IKernelAdapter__factory";
+export { IListaAdapter__factory } from "./IListaAdapter__factory";
+export { IMorphoAdapter__factory } from "./IMorphoAdapter__factory";
+export { IPendleAdapter__factory } from "./IPendleAdapter__factory";
+export { ISiloAdapter__factory } from "./ISiloAdapter__factory";
+export { ISparkAdapter__factory } from "./ISparkAdapter__factory";
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../typechain/factories/adapters/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/factories/adapters/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ISparkAdapter__factory = exports.ISiloAdapter__factory = exports.IPendleAdapter__factory = exports.IMorphoAdapter__factory = exports.IListaAdapter__factory = exports.IKernelAdapter__factory = exports.IEulerAdapter__factory = exports.ICompoundAdapter__factory = exports.IAaveV3BNBAdapter__factory = void 0;
+/* Autogenerated file. Do not edit manually. */
+/* tslint:disable */
+/* eslint-disable */
+var IAaveV3BNBAdapter__factory_1 = require("./IAaveV3BNBAdapter__factory");
+Object.defineProperty(exports, "IAaveV3BNBAdapter__factory", { enumerable: true, get: function () { return IAaveV3BNBAdapter__factory_1.IAaveV3BNBAdapter__factory; } });
+var ICompoundAdapter__factory_1 = require("./ICompoundAdapter__factory");
+Object.defineProperty(exports, "ICompoundAdapter__factory", { enumerable: true, get: function () { return ICompoundAdapter__factory_1.ICompoundAdapter__factory; } });
+var IEulerAdapter__factory_1 = require("./IEulerAdapter__factory");
+Object.defineProperty(exports, "IEulerAdapter__factory", { enumerable: true, get: function () { return IEulerAdapter__factory_1.IEulerAdapter__factory; } });
+var IKernelAdapter__factory_1 = require("./IKernelAdapter__factory");
+Object.defineProperty(exports, "IKernelAdapter__factory", { enumerable: true, get: function () { return IKernelAdapter__factory_1.IKernelAdapter__factory; } });
+var IListaAdapter__factory_1 = require("./IListaAdapter__factory");
+Object.defineProperty(exports, "IListaAdapter__factory", { enumerable: true, get: function () { return IListaAdapter__factory_1.IListaAdapter__factory; } });
+var IMorphoAdapter__factory_1 = require("./IMorphoAdapter__factory");
+Object.defineProperty(exports, "IMorphoAdapter__factory", { enumerable: true, get: function () { return IMorphoAdapter__factory_1.IMorphoAdapter__factory; } });
+var IPendleAdapter__factory_1 = require("./IPendleAdapter__factory");
+Object.defineProperty(exports, "IPendleAdapter__factory", { enumerable: true, get: function () { return IPendleAdapter__factory_1.IPendleAdapter__factory; } });
+var ISiloAdapter__factory_1 = require("./ISiloAdapter__factory");
+Object.defineProperty(exports, "ISiloAdapter__factory", { enumerable: true, get: function () { return ISiloAdapter__factory_1.ISiloAdapter__factory; } });
+var ISparkAdapter__factory_1 = require("./ISparkAdapter__factory");
+Object.defineProperty(exports, "ISparkAdapter__factory", { enumerable: true, get: function () { return ISparkAdapter__factory_1.ISparkAdapter__factory; } });

package/dist/factories/index.d.ts

@@ -0,0 +1,5 @@
+export * as adapters from "./adapters";
+export { IAllocationAdapter__factory } from "./IAllocationAdapter__factory";
+export { IPillarDMode__factory } from "./IPillarDMode__factory";
+export { IScoreEngine__factory } from "./IScoreEngine__factory";
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../typechain/factories/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/factories/index.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IScoreEngine__factory = exports.IPillarDMode__factory = exports.IAllocationAdapter__factory = exports.adapters = void 0;
+/* Autogenerated file. Do not edit manually. */
+/* tslint:disable */
+/* eslint-disable */
+exports.adapters = __importStar(require("./adapters"));
+var IAllocationAdapter__factory_1 = require("./IAllocationAdapter__factory");
+Object.defineProperty(exports, "IAllocationAdapter__factory", { enumerable: true, get: function () { return IAllocationAdapter__factory_1.IAllocationAdapter__factory; } });
+var IPillarDMode__factory_1 = require("./IPillarDMode__factory");
+Object.defineProperty(exports, "IPillarDMode__factory", { enumerable: true, get: function () { return IPillarDMode__factory_1.IPillarDMode__factory; } });
+var IScoreEngine__factory_1 = require("./IScoreEngine__factory");
+Object.defineProperty(exports, "IScoreEngine__factory", { enumerable: true, get: function () { return IScoreEngine__factory_1.IScoreEngine__factory; } });

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import type * as adapters from "./adapters";
+export type { adapters };
+export type { IAllocationAdapter } from "./IAllocationAdapter";
+export type { IPillarDMode } from "./IPillarDMode";
+export type { IScoreEngine } from "./IScoreEngine";
+export * as factories from "./factories";
+export type { IAaveV3BNBAdapter } from "./adapters/IAaveV3BNBAdapter";
+export { IAaveV3BNBAdapter__factory } from "./factories/adapters/IAaveV3BNBAdapter__factory";
+export type { ICompoundAdapter } from "./adapters/ICompoundAdapter";
+export { ICompoundAdapter__factory } from "./factories/adapters/ICompoundAdapter__factory";
+export type { IEulerAdapter } from "./adapters/IEulerAdapter";
+export { IEulerAdapter__factory } from "./factories/adapters/IEulerAdapter__factory";
+export type { IKernelAdapter } from "./adapters/IKernelAdapter";
+export { IKernelAdapter__factory } from "./factories/adapters/IKernelAdapter__factory";
+export type { IListaAdapter } from "./adapters/IListaAdapter";
+export { IListaAdapter__factory } from "./factories/adapters/IListaAdapter__factory";
+export type { IMorphoAdapter } from "./adapters/IMorphoAdapter";
+export { IMorphoAdapter__factory } from "./factories/adapters/IMorphoAdapter__factory";
+export type { IPendleAdapter } from "./adapters/IPendleAdapter";
+export { IPendleAdapter__factory } from "./factories/adapters/IPendleAdapter__factory";
+export type { ISiloAdapter } from "./adapters/ISiloAdapter";
+export { ISiloAdapter__factory } from "./factories/adapters/ISiloAdapter__factory";
+export type { ISparkAdapter } from "./adapters/ISparkAdapter";
+export { ISparkAdapter__factory } from "./factories/adapters/ISparkAdapter__factory";
+export { IAllocationAdapter__factory } from "./factories/IAllocationAdapter__factory";
+export { IPillarDMode__factory } from "./factories/IPillarDMode__factory";
+export { IScoreEngine__factory } from "./factories/IScoreEngine__factory";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../typechain/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,QAAQ,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,61 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IScoreEngine__factory = exports.IPillarDMode__factory = exports.IAllocationAdapter__factory = exports.ISparkAdapter__factory = exports.ISiloAdapter__factory = exports.IPendleAdapter__factory = exports.IMorphoAdapter__factory = exports.IListaAdapter__factory = exports.IKernelAdapter__factory = exports.IEulerAdapter__factory = exports.ICompoundAdapter__factory = exports.IAaveV3BNBAdapter__factory = exports.factories = void 0;
+exports.factories = __importStar(require("./factories"));
+var IAaveV3BNBAdapter__factory_1 = require("./factories/adapters/IAaveV3BNBAdapter__factory");
+Object.defineProperty(exports, "IAaveV3BNBAdapter__factory", { enumerable: true, get: function () { return IAaveV3BNBAdapter__factory_1.IAaveV3BNBAdapter__factory; } });
+var ICompoundAdapter__factory_1 = require("./factories/adapters/ICompoundAdapter__factory");
+Object.defineProperty(exports, "ICompoundAdapter__factory", { enumerable: true, get: function () { return ICompoundAdapter__factory_1.ICompoundAdapter__factory; } });
+var IEulerAdapter__factory_1 = require("./factories/adapters/IEulerAdapter__factory");
+Object.defineProperty(exports, "IEulerAdapter__factory", { enumerable: true, get: function () { return IEulerAdapter__factory_1.IEulerAdapter__factory; } });
+var IKernelAdapter__factory_1 = require("./factories/adapters/IKernelAdapter__factory");
+Object.defineProperty(exports, "IKernelAdapter__factory", { enumerable: true, get: function () { return IKernelAdapter__factory_1.IKernelAdapter__factory; } });
+var IListaAdapter__factory_1 = require("./factories/adapters/IListaAdapter__factory");
+Object.defineProperty(exports, "IListaAdapter__factory", { enumerable: true, get: function () { return IListaAdapter__factory_1.IListaAdapter__factory; } });
+var IMorphoAdapter__factory_1 = require("./factories/adapters/IMorphoAdapter__factory");
+Object.defineProperty(exports, "IMorphoAdapter__factory", { enumerable: true, get: function () { return IMorphoAdapter__factory_1.IMorphoAdapter__factory; } });
+var IPendleAdapter__factory_1 = require("./factories/adapters/IPendleAdapter__factory");
+Object.defineProperty(exports, "IPendleAdapter__factory", { enumerable: true, get: function () { return IPendleAdapter__factory_1.IPendleAdapter__factory; } });
+var ISiloAdapter__factory_1 = require("./factories/adapters/ISiloAdapter__factory");
+Object.defineProperty(exports, "ISiloAdapter__factory", { enumerable: true, get: function () { return ISiloAdapter__factory_1.ISiloAdapter__factory; } });
+var ISparkAdapter__factory_1 = require("./factories/adapters/ISparkAdapter__factory");
+Object.defineProperty(exports, "ISparkAdapter__factory", { enumerable: true, get: function () { return ISparkAdapter__factory_1.ISparkAdapter__factory; } });
+var IAllocationAdapter__factory_1 = require("./factories/IAllocationAdapter__factory");
+Object.defineProperty(exports, "IAllocationAdapter__factory", { enumerable: true, get: function () { return IAllocationAdapter__factory_1.IAllocationAdapter__factory; } });
+var IPillarDMode__factory_1 = require("./factories/IPillarDMode__factory");
+Object.defineProperty(exports, "IPillarDMode__factory", { enumerable: true, get: function () { return IPillarDMode__factory_1.IPillarDMode__factory; } });
+var IScoreEngine__factory_1 = require("./factories/IScoreEngine__factory");
+Object.defineProperty(exports, "IScoreEngine__factory", { enumerable: true, get: function () { return IScoreEngine__factory_1.IScoreEngine__factory; } });

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "alia-contracts-spec",
+  "version": "0.1.0",
+  "description": "ALIA Quality Network — contract interfaces and ABIs for integration. 12 Solidity interfaces (3 core + 9 adapters) for Score, Allocation, and Pillar D modes consumable on BNB Chain testnet/mainnet.",
+  "license": "BUSL-1.1",
+  "homepage": "https://github.com/alia-core/alia-contracts-spec#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alia-core/alia-contracts-spec.git"
+  },
+  "bugs": {
+    "url": "https://github.com/alia-core/alia-contracts-spec/issues"
+  },
+  "author": "Avvatar Labs SAS",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "abi/",
+    "src/interfaces/",
+    "src/adapters/interfaces/",
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "alia",
+    "alia-quality-network",
+    "defi",
+    "ethereum",
+    "bnb-chain",
+    "agentic",
+    "quality",
+    "pillar-d",
+    "stablecoin",
+    "yield"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "forge build && node scripts/extract-abis.js && npm run typechain && npm run tsc",
+    "typechain": "typechain --target ethers-v6 --out-dir typechain/ 'abi/**/*.json'",
+    "tsc": "tsc",
+    "clean": "rm -rf abi/ typechain/ dist/ out/ cache/",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "ethers": ">=6.0.0"
+  },
+  "devDependencies": {
+    "@typechain/ethers-v6": "^0.5.1",
+    "typechain": "^8.3.2",
+    "ethers": "^6.13.0",
+    "typescript": "^5.5.0"
+  }
+}

package/src/adapters/interfaces/IAaveV3BNBAdapter.sol

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+//  IAaveV3BNBAdapter — ALIA Quality Network · negotiation hook
+//
+//  Production adapter spec for Aave V3 on BNB Chain.
+//  Reference: Aave V3 Pool 0x6807dc923806fE8Fd134338EABCA509979a7e0cB (BNB mainnet)
+//
+//  Stani Kulechov / Aave Labs team integration scope (3-5 days):
+//    1. Implement IAllocationAdapter base via IAaveV3BNBAdapter extension
+//    2. Pool.supply() wraps user asset → aToken receipt
+//    3. Pool.withdraw() unwraps aToken → asset
+//    4. expectedAPY pulls from Pool.getReserveData().currentLiquidityRate
+//    5. Audit ALIA core team (bytecode hash + score attestation)
+//    6. Register via QualityGatedAllocator.registerAdapter()
+// ═══════════════════════════════════════════════════════════════════════════════
+
+interface IAaveV3BNBAdapter is IAllocationAdapter {
+
+    /// @notice Aave V3 Pool contract reference
+    function aavePool() external view returns (address);
+
+    /// @notice aToken receipt for a given underlying asset
+    function aTokenFor(address asset) external view returns (address);
+
+    /// @notice Current variable borrow rate (annualized bps) — for future leverage V1
+    function variableBorrowRate(address asset) external view returns (uint16 bps);
+
+    /// @notice Aave V3 reserve normalized income (RAY 1e27)
+    function getReserveNormalizedIncome(address asset) external view returns (uint256);
+}

package/src/adapters/interfaces/ICompoundAdapter.sol

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+//  ICompoundAdapter — ALIA Quality Network · negotiation hook
+//
+//  Compound V3 (Comet) integration. Single-asset markets per base token.
+//  Reference: cUSDCv3 / cWETHv3 / cUSDTv3 deployed multi-chain.
+//
+//  Compound Labs / OpenZeppelin team integration scope (3-5 days):
+//    1. Comet.supply(asset, amount) → base token receipt
+//    2. expectedAPY via Comet.getUtilization() + getSupplyRate()
+// ═══════════════════════════════════════════════════════════════════════════════
+
+interface ICompoundAdapter is IAllocationAdapter {
+    function cometFor(address asset) external view returns (address);
+    function utilization(address asset) external view returns (uint256);
+    function getSupplyRatePerSecond(address asset) external view returns (uint256);
+}

package/src/adapters/interfaces/IEulerAdapter.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+interface IEulerAdapter is IAllocationAdapter {
+    function vaultFor(address asset) external view returns (address);
+    function interestRate(address asset) external view returns (uint256);
+    function eTokenFor(address asset) external view returns (address);
+}

package/src/adapters/interfaces/IKernelAdapter.sol

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+// ═══════════════════════════════════════════════════════════════════════════════
+//  IKernelAdapter — ALIA Quality Network · negotiation hook
+//
+//  Production adapter spec for Kernel (BNB-native restaking + LRT).
+//  Reference: Kernel Protocol — BNB Chain restaking layer
+//
+//  Kernel team integration scope (3-5 days):
+//    1. Stake user asset → kBNB / kETH receipt token
+//    2. expectedAPY = base staking yield + restaking rewards
+//    3. Withdraw with cooldown period (typical 7 days BNB-side)
+// ═══════════════════════════════════════════════════════════════════════════════
+
+interface IKernelAdapter is IAllocationAdapter {
+
+    function kernelManager() external view returns (address);
+
+    /// @notice Receipt token (LRT) for a given underlying staked asset
+    function lrtFor(address asset) external view returns (address);
+
+    /// @notice Cooldown period in seconds before withdrawal claimable
+    function cooldownPeriod() external view returns (uint256);
+
+    /// @notice Pending withdrawal request for caller on a given asset
+    function pendingWithdrawal(address asset, address owner) external view returns (uint256 amount, uint256 unlockAt);
+}

package/src/adapters/interfaces/IListaAdapter.sol

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+interface IListaAdapter is IAllocationAdapter {
+    function listaStaking() external view returns (address);
+    function listaRWAModule() external view returns (address);
+    function moduleFor(address asset) external view returns (string memory);
+    function slisBNBRate() external view returns (uint256);
+}

package/src/adapters/interfaces/IMorphoAdapter.sol

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+interface IMorphoAdapter is IAllocationAdapter {
+
+    struct MarketParams {
+        address loanToken;
+        address collateralToken;
+        address oracle;
+        address irm;
+        uint256 lltv;
+    }
+
+    function morphoBlue() external view returns (address);
+    function marketIdFor(address asset) external view returns (bytes32);
+    function marketParamsFor(address asset) external view returns (MarketParams memory);
+}

package/src/adapters/interfaces/IPendleAdapter.sol

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+interface IPendleAdapter is IAllocationAdapter {
+    function pendleRouter() external view returns (address);
+    function marketFor(address asset) external view returns (address);
+    function ptToken(address market) external view returns (address);
+    function ytToken(address market) external view returns (address);
+    function maturity(address market) external view returns (uint256);
+    function fixedYieldBps(address market) external view returns (uint16);
+}

package/src/adapters/interfaces/ISiloAdapter.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+interface ISiloAdapter is IAllocationAdapter {
+    function siloFor(address asset) external view returns (address);
+    function shareTokenFor(address asset) external view returns (address);
+    function getInterestRate(address asset) external view returns (uint256);
+}

package/src/adapters/interfaces/ISparkAdapter.sol

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+import {IAllocationAdapter} from "../../interfaces/IAllocationAdapter.sol";
+
+interface ISparkAdapter is IAllocationAdapter {
+    function sparkPool() external view returns (address);
+    function spTokenFor(address asset) external view returns (address);
+    function dsrRateBps() external view returns (uint16);
+    function isD3MActive(address asset) external view returns (bool);
+}

package/src/interfaces/IAllocationAdapter.sol

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+// ═══════════════════════════════════════════════════════════════════════════════
+//  IAllocationAdapter — ALIA Quality Network · alia-core/alia-engine
+//
+//  Interface canonical réutilisable pour tout protocole de lending/yield
+//  adressable par QualityGatedAllocator + PillarDRouter (Mode 1 Yield Boosted).
+//
+//  Pattern stratégique :
+//    Cette interface est le "negotiation hook" pour onboarder n'importe quel
+//    protocole DeFi (Aave V3 BNB, Morpho, Pendle, Kernel, Lista, Spark,
+//    Compound, Euler, Silo, Venus, etc.) en 3-5 jours par adapter.
+//
+//    Le pattern Federated by Design Pilier 4 V25 opérationnel :
+//      1. Protocole self-registers via AdapterRegistry.requestAdapterListing()
+//      2. ALIA core team audit bytecode + score attestation
+//      3. ALIA Quality Badge soulbound mint sur adapter address
+//      4. Adapter devient éligible capital flow PillarDRouter
+//
+//  V0 scope sprint sem 1-2 (supply-only, cohérent VenusAdapter v0.1.0 12 mai) :
+//    - supply(asset, amount) → received
+//    - withdraw(asset, amount) → withdrawn
+//    - balanceOf(asset, owner) → balance
+//    - expectedAPY(asset) → bps annualized
+//    - adapterType() + protocolName() metadata pure
+//
+//  V1 scope Y1H2 (borrow + repay + leverage) :
+//    - borrow/repay added when PillarDRouter Mode 2 Tranching implements
+//      senior/junior leverage logic Q4 2026
+//
+//  V2 scope Y2H1 (cross-protocol routing optimization) :
+//    - swap/rebalance hooks when AGIL-4 Decision Orchestrator industrialised
+// ═══════════════════════════════════════════════════════════════════════════════
+
+interface IAllocationAdapter {
+
+    /// @notice Supply assets to the underlying protocol (lending/yield)
+    /// @dev    Caller MUST have approved this adapter to spend `amount` of `asset`
+    /// @param  asset Token address to supply (USDC, USDT, FDUSD, etc.)
+    /// @param  amount Amount to supply in token native decimals
+    /// @return received Amount of receipt token (vToken, aToken, mToken) credited
+    function supply(address asset, uint256 amount) external returns (uint256 received);
+
+    /// @notice Withdraw assets from the underlying protocol
+    /// @dev    Caller MUST have a balance on this adapter (via prior supply)
+    /// @param  asset Token address to withdraw
+    /// @param  amount Amount to withdraw in token native decimals (or type(uint256).max for full)
+    /// @return withdrawn Actual amount of asset received back
+    function withdraw(address asset, uint256 amount) external returns (uint256 withdrawn);
+
+    /// @notice Read user balance on the underlying protocol
+    /// @param  asset Token address
+    /// @param  owner Address whose balance to read
+    /// @return Balance in token native decimals (asset, not receipt token)
+    function balanceOf(address asset, address owner) external view returns (uint256);
+
+    /// @notice Expected annualized yield for supplying `asset` to this adapter
+    /// @dev    Returned in basis points (bps), e.g. 850 = 8.50% APY
+    ///         MUST reflect current market conditions, not historical
+    ///         MAY revert if market not initialised on the protocol
+    /// @param  asset Token address
+    /// @return bps Annualized yield in basis points
+    function expectedAPY(address asset) external view returns (uint16 bps);
+
+    /// @notice Adapter category for routing logic
+    /// @return Type tag — "LENDING" | "YIELD_AGG" | "VAULT" | "RWA" | "STRUCTURED"
+    function adapterType() external pure returns (string memory);
+
+    /// @notice Protocol name (display + AdapterRegistry indexing)
+    /// @return Name — "Venus" | "Aave-V3-BNB" | "Morpho" | "Pendle" | "Kernel" | etc.
+    function protocolName() external pure returns (string memory);
+
+    // ─── Events (recommended emission patterns) ─────────────────────────────────
+
+    event Supplied(address indexed caller, address indexed asset, uint256 amount, uint256 received);
+    event Withdrawn(address indexed caller, address indexed asset, uint256 amount, uint256 withdrawn);
+}

package/src/interfaces/IPillarDMode.sol

@@ -0,0 +1,85 @@
+// SPDX-License-Identifier: BUSL-1.1
+pragma solidity ^0.8.24;
+
+// ═══════════════════════════════════════════════════════════════════════════════
+//  IPillarDMode — ALIA Quality Network · alia-core/alia-engine
+//
+//  Interface commune pour tous les modes Pillar D Stable Capital Edge V25.
+//
+//  3 modes paramétrables Memo V7 §7.3 :
+//    Mode 1 — YieldBoostedMode      : yield boosté 8-15% APY quality-gated (V0 J3)
+//    Mode 2 — TranchingMode         : senior 6-7% / junior 15-25% (interface J3, impl Q4 2026)
+//    Mode 3 — IncomeStreamingMode   : flux mensuel fixe annuity pattern (interface J3, impl Y2H1 2027)
+//
+//  PillarDRouter dispatche deposit(mode) → Mode contract.
+//  Chaque mode implémente vault ERC-4626-compatible avec shares accounting.
+// ═══════════════════════════════════════════════════════════════════════════════
+
+interface IPillarDMode {
+
+    /// @notice Mode identifier (for routing + telemetry)
+    /// @return Mode tag — "YIELD_BOOSTED" | "TRANCHING" | "INCOME_STREAMING"
+    function modeName() external pure returns (string memory);
+
+    /// @notice Mode version (semver-like for upgrade tracking)
+    function modeVersion() external pure returns (string memory);
+
+    /// @notice Deposit assets into the mode vault
+    /// @dev    Caller MUST have approved this contract for `amount` of `asset`
+    /// @param  asset       Token deposited
+    /// @param  amount      Amount in asset native decimals
+    /// @param  receiver    Address to credit shares to
+    /// @param  mandateId   Mandate driving quality gating + risk policy
+    /// @return shares      Vault shares minted to receiver
+    function deposit(
+        address asset,
+        uint256 amount,
+        address receiver,
+        bytes32 mandateId
+    ) external returns (uint256 shares);
+
+    /// @notice Withdraw assets by redeeming vault shares
+    /// @param  asset       Token to redeem
+    /// @param  shares      Vault shares to burn (type(uint256).max = full position)
+    /// @param  receiver    Address to receive withdrawn assets
+    /// @return assets      Amount of asset transferred to receiver
+    function redeem(
+        address asset,
+        uint256 shares,
+        address receiver
+    ) external returns (uint256 assets);
+
+    /// @notice Total shares outstanding for an asset
+    function totalShares(address asset) external view returns (uint256);
+
+    /// @notice Total assets under management for an asset (incl. accrued yield)
+    function totalAssets(address asset) external view returns (uint256);
+
+    /// @notice User's share balance for an asset
+    function shareBalanceOf(address asset, address user) external view returns (uint256);
+
+    /// @notice Convert shares to underlying asset amount (current exchange rate)
+    function convertToAssets(address asset, uint256 shares) external view returns (uint256);
+
+    /// @notice Convert asset amount to shares (current exchange rate)
+    function convertToShares(address asset, uint256 amount) external view returns (uint256);
+
+    // ─── Events ───────────────────────────────────────────────────────────────
+
+    event Deposit(
+        address indexed sender,
+        address indexed receiver,
+        address indexed asset,
+        uint256 amount,
+        uint256 shares,
+        bytes32 mandateId
+    );
+
+    event Redeem(
+        address indexed sender,
+        address indexed receiver,
+        address indexed asset,
+        uint256 shares,
+        uint256 assets
+    );
+}