@agentsgot/agent-kit 0.0.0-stage → 1.0.1

package/vendor/shared/params/ranges.json

@@ -0,0 +1,574 @@
+{
+  "tokenTotalAgt": {
+    "fixed": true
+  },
+  "treasuryGenesisAgt": {
+    "fixed": true
+  },
+  "liquidityGenesisAgt": {
+    "fixed": true
+  },
+  "teamGenesisAgt": {
+    "fixed": true
+  },
+  "tierDailyFee.T1": {
+    "min": 100,
+    "max": 1000
+  },
+  "tierDailyFee.T2": {
+    "min": 500,
+    "max": 5000
+  },
+  "tierDailyFee.T3": {
+    "min": 5000,
+    "max": 50000
+  },
+  "tierDailyFee.T4": {
+    "min": 20000,
+    "max": 150000
+  },
+  "tierDailyFee.T5": {
+    "min": 50000,
+    "max": 500000
+  },
+  "tierDaysMin.T1": {
+    "min": 1,
+    "max": 3
+  },
+  "tierDaysMin.T2": {
+    "min": 1,
+    "max": 3
+  },
+  "tierDaysMin.T3": {
+    "min": 1,
+    "max": 7
+  },
+  "tierDaysMin.T4": {
+    "min": 1,
+    "max": 7
+  },
+  "tierDaysMin.T5": {
+    "min": 1,
+    "max": 7
+  },
+  "tierDaysMax.T1": {
+    "min": 3,
+    "max": 14
+  },
+  "tierDaysMax.T2": {
+    "min": 7,
+    "max": 30
+  },
+  "tierDaysMax.T3": {
+    "min": 14,
+    "max": 60
+  },
+  "tierDaysMax.T4": {
+    "min": 30,
+    "max": 90
+  },
+  "tierDaysMax.T5": {
+    "min": 14,
+    "max": 120
+  },
+  "tierBaseQuota.T1": {
+    "min": 1,
+    "max": 5
+  },
+  "tierBaseQuota.T2": {
+    "min": 3,
+    "max": 10
+  },
+  "tierBaseQuota.T3": {
+    "min": 5,
+    "max": 15
+  },
+  "submissionMultiplier": {
+    "min": 2,
+    "max": 5
+  },
+  "tierRangeOffset": {
+    "min": 1,
+    "max": 3
+  },
+  "participantsDefault": {
+    "fixed": true
+  },
+  "participantsMin": {
+    "fixed": true
+  },
+  "participantsWarning": {
+    "fixed": true
+  },
+  "participantsMax": {
+    "fixed": true
+  },
+  "deductionExecBps": {
+    "min": 5000,
+    "max": 8000
+  },
+  "deductionTestBps": {
+    "min": 1000,
+    "max": 2000
+  },
+  "deductionRevBps": {
+    "min": 500,
+    "max": 1500
+  },
+  "deductionPlatBps": {
+    "min": 300,
+    "max": 1000
+  },
+  "assessmentFeeBaseBps": {
+    "min": 200,
+    "max": 1000
+  },
+  "passingThresholdDefault": {
+    "min": 50,
+    "max": 90
+  },
+  "passingThresholdMin": {
+    "fixed": true
+  },
+  "passingThresholdMax": {
+    "fixed": true
+  },
+  "junkThreshold": {
+    "min": 10,
+    "max": 30
+  },
+  "emissionHalfLifeDays": {
+    "min": 365,
+    "max": 1825
+  },
+  "unrecoverableCostBps": {
+    "min": 300,
+    "max": 1500
+  },
+  "emissionPlatformBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "emissionExecBps": {
+    "min": 5000,
+    "max": 8000
+  },
+  "emissionTestBps": {
+    "min": 500,
+    "max": 3000
+  },
+  "emissionArbBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "arbCaseBonusBps.T1": {
+    "min": 0,
+    "max": 2000
+  },
+  "arbCaseBonusBps.T2": {
+    "min": 0,
+    "max": 2000
+  },
+  "arbCaseBonusBps.T3": {
+    "min": 0,
+    "max": 3000
+  },
+  "arbCaseBonusBps.T4": {
+    "min": 0,
+    "max": 3000
+  },
+  "arbCaseBonusBps.T5": {
+    "min": 0,
+    "max": 5000
+  },
+  "anchorIntervalHours": {
+    "min": 1,
+    "max": 6
+  },
+  "executorAppealWindowMinutes": {
+    "min": 5,
+    "max": 2880
+  },
+  "appealRetestHours": {
+    "min": 12,
+    "max": 72
+  },
+  "appealFeeBps": {
+    "min": 100,
+    "max": 1000
+  },
+  "appealFeeCapAgt": {
+    "min": 100,
+    "max": 10000
+  },
+  "appealRetestCount": {
+    "fixed": true
+  },
+  "openClaimPeriodDays": {
+    "min": 3,
+    "max": 14
+  },
+  "escalationStepMinHours": {
+    "min": 2,
+    "max": 12
+  },
+  "escalationStepPctBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "earliestSubmitPctBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "earliestSubmitMinHours": {
+    "min": 1,
+    "max": 6
+  },
+  "earliestSubmitMaxHours": {
+    "min": 24,
+    "max": 168
+  },
+  "graceHours": {
+    "min": 12,
+    "max": 48
+  },
+  "publisherReviewHours": {
+    "min": 24,
+    "max": 72
+  },
+  "noSubmissionFallbackDays": {
+    "min": 3,
+    "max": 30
+  },
+  "testerCount": {
+    "fixed": true
+  },
+  "testerReportWindowHours": {
+    "min": 12,
+    "max": 72
+  },
+  "testerReportExtendedWindowHours": {
+    "min": 24,
+    "max": 96
+  },
+  "testerRedrawRoundsMax": {
+    "min": 1,
+    "max": 4
+  },
+  "testerPairDecayBps.1": {
+    "fixed": true
+  },
+  "testerPairDecayBps.2": {
+    "min": 5000,
+    "max": 9000
+  },
+  "testerPairDecayBps.3": {
+    "min": 2000,
+    "max": 7000
+  },
+  "testerPairDecayBps.4": {
+    "min": 1000,
+    "max": 5000
+  },
+  "testerPairDecayBps.5": {
+    "min": 0,
+    "max": 3000
+  },
+  "reviewerCount.T1": {
+    "fixed": true
+  },
+  "reviewerCount.T2": {
+    "fixed": true
+  },
+  "reviewerCount.T3": {
+    "fixed": true
+  },
+  "vestingT0Bps": {
+    "min": 5000,
+    "max": 8000
+  },
+  "vestingT1Bps": {
+    "min": 1000,
+    "max": 3000
+  },
+  "vestingT1Days": {
+    "min": 3,
+    "max": 14
+  },
+  "vestingT2Days": {
+    "min": 14,
+    "max": 60
+  },
+  "maintenanceDays": {
+    "min": 14,
+    "max": 60
+  },
+  "publisherExposureBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "publisherBaseStakeAgt": {
+    "min": 5,
+    "max": 50
+  },
+  "arbitratorMinStakeAgt": {
+    "min": 100000,
+    "max": 5000000
+  },
+  "testerMinStakeAgt": {
+    "min": 1000,
+    "max": 200000
+  },
+  "validatorStakeAgt.voluntaryMax": {
+    "min": 20000,
+    "max": 10000000
+  },
+  "arbitratorWeightCapAgt": {
+    "min": 1000000,
+    "max": 10000000
+  },
+  "testerWeightCapAgt": {
+    "min": 20000,
+    "max": 1000000
+  },
+  "validatorInitialLockHours": {
+    "min": 168,
+    "max": 720
+  },
+  "validatorExitCooldownHours": {
+    "min": 72,
+    "max": 336
+  },
+  "executorPenaltyCooldownHours": {
+    "min": 0,
+    "max": 720
+  },
+  "arbPoolBootstrapMin": {
+    "min": 5,
+    "max": 20
+  },
+  "randomBlockOffset": {
+    "min": 3,
+    "max": 10
+  },
+  "signatureUploadToleranceHours": {
+    "min": 1,
+    "max": 3
+  },
+  "caseLockBps": {
+    "min": 200,
+    "max": 1000
+  },
+  "caseLockMinAgt": {
+    "min": 0.5,
+    "max": 500
+  },
+  "caseLockStakeCapBps": {
+    "min": 1000,
+    "max": 3000
+  },
+  "arbitratorConcurrentCasesMax": {
+    "min": 1,
+    "max": 5
+  },
+  "arbExposureMultiplierBps.Full": {
+    "min": 10000,
+    "max": 60000
+  },
+  "arbExposureMultiplierBps.Degraded": {
+    "min": 5000,
+    "max": 30000
+  },
+  "arbFallbackMaxDisputeValueAgt": {
+    "min": 1000,
+    "max": 100000
+  },
+  "arbPendingMaxHours": {
+    "min": 72,
+    "max": 720
+  },
+  "arbSourceWeightCapBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "arbConflictLookbackHours": {
+    "min": 168,
+    "max": 2160
+  },
+  "arbMinRevealBps": {
+    "fixed": true
+  },
+  "arbResponseWindowHours": {
+    "min": 168,
+    "max": 2160
+  },
+  "arbPanelSize.FullFirst": {
+    "fixed": true
+  },
+  "arbPanelSize.FullFinal": {
+    "fixed": true
+  },
+  "arbPanelSize.DegradedFirst": {
+    "fixed": true
+  },
+  "arbPanelSize.DegradedFinal": {
+    "fixed": true
+  },
+  "arbFallbackTesterCount": {
+    "fixed": true
+  },
+  "arbFallbackApprovalCount": {
+    "fixed": true
+  },
+  "arbFallbackReportWindowHours": {
+    "min": 6,
+    "max": 72
+  },
+  "arbMinimumPoolSize": {
+    "min": 14,
+    "max": 30
+  },
+  "arbFullPanelThreshold": {
+    "min": 30,
+    "max": 80
+  },
+  "arbFullPanelRecoveryHours": {
+    "min": 72,
+    "max": 336
+  },
+  "arbAcceptWindowHours": {
+    "min": 1,
+    "max": 6
+  },
+  "arbRedrawRoundsMax": {
+    "min": 1,
+    "max": 4
+  },
+  "arbStatementMaxChars": {
+    "min": 500,
+    "max": 5000
+  },
+  "arbCommitWindowHours": {
+    "min": 12,
+    "max": 48
+  },
+  "arbRevealWindowHours": {
+    "min": 6,
+    "max": 24
+  },
+  "attendanceFeeMaxAgt": {
+    "min": 0.1,
+    "max": 2
+  },
+  "attendanceForecastHours": {
+    "min": 168,
+    "max": 2160
+  },
+  "arbPoolSweepIntervalHours": {
+    "min": 72,
+    "max": 336
+  },
+  "arbPoolReserveHorizonHours": {
+    "min": 720,
+    "max": 4320
+  },
+  "caseFeeBps": {
+    "min": 200,
+    "max": 1000
+  },
+  "caseFeeMinAgt": {
+    "min": 2,
+    "max": 20
+  },
+  "caseFeeMajorityShareBps": {
+    "fixed": true
+  },
+  "caseFeeWinnerShareBps": {
+    "fixed": true
+  },
+  "caseFeePlatformShareBps": {
+    "fixed": true
+  },
+  "appealBondMultiplierBps": {
+    "min": 15000,
+    "max": 30000
+  },
+  "missedCommitSlashBps": {
+    "min": 0,
+    "max": 5000
+  },
+  "missedRevealSlashBps": {
+    "min": 0,
+    "max": 10000
+  },
+  "finalMinoritySlashBps": {
+    "min": 0,
+    "max": 3000
+  },
+  "challengerRewardMultiple": {
+    "min": 1,
+    "max": 20
+  },
+  "overturnPlatformShareBps": {
+    "fixed": true
+  },
+  "overturnRighteousShareBps": {
+    "fixed": true
+  },
+  "collusionReporterRewardBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "collusionArbPoolShareBps": {
+    "min": 8000,
+    "max": 9500
+  },
+  "arbResponseRateMinBps": {
+    "min": 3000,
+    "max": 8000
+  },
+  "arbOverturnPauseCount": {
+    "min": 2,
+    "max": 4
+  },
+  "arbOverturnDisqualifyCount": {
+    "min": 3,
+    "max": 6
+  },
+  "arbDisqualifyHours": {
+    "min": 2160,
+    "max": 17520
+  },
+  "arbSuspensionHours": {
+    "min": 168,
+    "max": 2160
+  },
+  "arbMinorityStreakPenaltyCount": {
+    "min": 3,
+    "max": 10
+  },
+  "testerMissReportSlashMultiple": {
+    "min": 1,
+    "max": 10
+  },
+  "testerSlashStakeCapBps": {
+    "min": 500,
+    "max": 2000
+  },
+  "voucherClaimWindowHours": {
+    "min": 24,
+    "max": 168
+  },
+  "tradeTaxBurnShareBps": {
+    "min": 0,
+    "max": 10000
+  },
+  "tradeTaxPlatformShareBps": {
+    "min": 0,
+    "max": 10000
+  },
+  "tradeTaxLiquidityShareBps": {
+    "min": 0,
+    "max": 10000
+  }
+}

package/vendor/shared/src/emission-schedule.ts

@@ -0,0 +1,151 @@
+/** Bit-exact continuous emission schedule matching EmissionController fixed-point math. */
+
+export const WAD = 10n ** 18n;
+export const HOUR = 3600n;
+export const BPS = 10_000n;
+const LN2_18 = 693_147_180_559_945_309n;
+
+export type Schedule = {
+  startTime: bigint;
+  initialBalance: bigint;
+  hourDecay18: bigint;
+  platformBps: bigint;
+  execBps: bigint;
+  testBps: bigint;
+};
+
+export type CumulativeShares = {
+  released: bigint;
+  platform: bigint;
+  exec: bigint;
+  test: bigint;
+  arb: bigint;
+};
+
+export type HourShares = {
+  emission: bigint;
+  platform: bigint;
+  exec: bigint;
+  test: bigint;
+  arb: bigint;
+};
+
+/** Floor(a * b / d), matching OpenZeppelin Math.mulDiv for non-overflowing inputs. */
+export function mulDiv(a: bigint, b: bigint, d: bigint): bigint {
+  if (d === 0n) throw new Error("mulDiv: division by zero");
+  return (a * b) / d;
+}
+
+/** 2^(-1/n) via bounded Taylor expansion — matches EmissionController._pow2Neg. */
+export function pow2Neg(n: bigint): bigint {
+  if (n === 0n) throw new Error("pow2Neg: n must be > 0");
+  const x = mulDiv(LN2_18, WAD, n * WAD);
+  let term = WAD;
+  let sum = WAD;
+  for (let i = 1n; i <= 24n; i++) {
+    term = mulDiv(term, x, WAD) / i;
+    if ((i & 1n) === 1n) sum -= term;
+    else sum += term;
+  }
+  return sum;
+}
+
+/** Hourly decay factor q = 2^(-1/(24H)). */
+export function hourDecay18(halfLifeDays: bigint): bigint {
+  return pow2Neg(halfLifeDays * 24n);
+}
+
+/** Exponentiation by squaring in WAD: x^k with floor after each multiply. */
+export function powWad(x: bigint, k: bigint): bigint {
+  if (k === 0n) return WAD;
+  let base = x;
+  let exp = k;
+  let result = WAD;
+  while (exp > 0n) {
+    if ((exp & 1n) === 1n) result = mulDiv(result, base, WAD);
+    base = mulDiv(base, base, WAD);
+    exp >>= 1n;
+  }
+  return result;
+}
+
+export function firstHour(schedule: Schedule): bigint {
+  return schedule.startTime / HOUR;
+}
+
+function remain(schedule: Schedule, k: bigint): bigint {
+  return mulDiv(schedule.initialBalance, powWad(schedule.hourDecay18, k), WAD);
+}
+
+function rk(schedule: Schedule, k: bigint): bigint {
+  return schedule.initialBalance - remain(schedule, k);
+}
+
+/** Cumulative released amount R(t) at absolute unix time t. */
+export function cumulativeReleased(schedule: Schedule, t: bigint): bigint {
+  if (t <= schedule.startTime) return 0n;
+  const s = t - schedule.startTime;
+  const k = s / HOUR;
+  const r = s % HOUR;
+  const rk0 = rk(schedule, k);
+  if (r === 0n) return rk0;
+  const rk1 = rk(schedule, k + 1n);
+  return rk0 + ((rk1 - rk0) * r) / HOUR;
+}
+
+export function cumulativeShares(schedule: Schedule, t: bigint): CumulativeShares {
+  const released = cumulativeReleased(schedule, t);
+  const platform = mulDiv(released, schedule.platformBps, BPS);
+  const exec = mulDiv(released, schedule.execBps, BPS);
+  const test = mulDiv(released, schedule.testBps, BPS);
+  const arb = released - platform - exec - test;
+  return { released, platform, exec, test, arb };
+}
+
+function sharesDelta(a: CumulativeShares, b: CumulativeShares): HourShares {
+  return {
+    emission: b.released - a.released,
+    platform: b.platform - a.platform,
+    exec: b.exec - a.exec,
+    test: b.test - a.test,
+    arb: b.arb - a.arb,
+  };
+}
+
+/** Shares released during absolute hour `hourId` (activation hour is partial). */
+export function hourShares(schedule: Schedule, hourId: bigint): HourShares {
+  const hourStart = hourId * HOUR;
+  const hourEnd = hourStart + HOUR;
+  const a = hourStart < schedule.startTime ? schedule.startTime : hourStart;
+  if (a >= hourEnd) {
+    return { emission: 0n, platform: 0n, exec: 0n, test: 0n, arb: 0n };
+  }
+  return sharesDelta(cumulativeShares(schedule, a), cumulativeShares(schedule, hourEnd));
+}
+
+/** Arbitration share emitted in [from, to) clipped to [startTime, …). */
+export function arbitrationEmitted(schedule: Schedule, from: bigint, to: bigint): bigint {
+  if (to <= from) return 0n;
+  const t1 = from < schedule.startTime ? schedule.startTime : from;
+  const t2 = to;
+  if (t2 <= t1) return 0n;
+  return cumulativeShares(schedule, t2).arb - cumulativeShares(schedule, t1).arb;
+}
+
+export function buildSchedule(input: {
+  startTime: bigint;
+  initialBalance: bigint;
+  halfLifeDays: bigint;
+  platformBps: bigint;
+  execBps: bigint;
+  testBps: bigint;
+}): Schedule {
+  return {
+    startTime: input.startTime,
+    initialBalance: input.initialBalance,
+    hourDecay18: hourDecay18(input.halfLifeDays),
+    platformBps: input.platformBps,
+    execBps: input.execBps,
+    testBps: input.testBps,
+  };
+}

package/vendor/shared/src/index.ts

@@ -0,0 +1,6 @@
+export * from "./emission-schedule.js";
+export * from "./params/index.js";
+export * from "./protocol-proofs.js";
+export * from "./rules/index.js";
+export * from "./schemas/index.js";
+export * from "./units.js";