citrate-labs-sdk 0.6.0__tar.gz

citrate_labs_sdk-0.6.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to `citrate-labs-sdk` are documented here. This project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [0.6.0] - 2026-07-26 — DevX Convergence
+
+### Added
+- **Federation contract artifact** (`citrate_sdk._generated.contract`): the single source of
+  truth for chain addresses, chainId, endpoints, and the entitlement tier vocabulary, vendored
+  from the generated `federation-contract.json` and drift-gated (`scripts/sync_contract.py`).
+- **Identity spine + embedded wallet** (`citrate_sdk.identity`): OIDC PKCE + SIWE, hardened
+  `verify_id_token` (RS256; rejects alg:none / alg-confusion / bad aud/iss / expired / tampered),
+  `IdentityClient` (discover / authorize / exchange / refresh / userinfo → capabilities / deploy
+  permit / guardians / logout), and smart-account address prediction
+  (`predict_wallet_address` / `verify_wallet_address_on_chain`) verified byte-for-byte against
+  the on-chain factory — never trusting the authority's `/aa/address`.
+- **Entitlement capabilities** (`citrate_sdk.entitlements`): canonical `normalize_tier`
+  (unknown → public, never escalates) + capability map (`commercial.kyc` opens transactions,
+  not content; no global rank).
+- **Inference gateway client** (`citrate_sdk.gateway`): OpenAI-compatible over
+  `infer.citrate.ai`, `cgk_` bearer, typed 401/402/429/503, fail-closed without a key.
+- **Command line** (`citrate`): `contract`, `wallet predict`, `entitlement`, `gateway` — fixes
+  the previously-declared-but-missing `citrate_sdk.cli:main` entry point.
+- **`py.typed`** marker so type checkers recognize the package's inline types.
+
+### Notes
+- All new crypto uses existing dependencies (`eth_utils`, `cryptography`, `requests`) — no new
+  runtime dependencies.
+- Cross-language parity: address prediction and capability answers match the JavaScript SDK
+  (`@citratenetwork/sdk`) exactly.

citrate_labs_sdk-0.6.0/LICENSE

@@ -0,0 +1,145 @@
+SPDX-FileCopyrightText: 2026 Mozi Cooperative
+SPDX-License-Identifier: BUSL-1.1
+
+Citrate — Business Source License 1.1 Parameters and Additional Use Grant
+
+Licensor: Mozi Cooperative
+
+Licensed Work: The Citrate software, source code, binaries, SDKs, browser wallet,
+desktop applications, formal specifications, documentation, design assets,
+configuration, examples, and related materials made available by or on behalf of
+Mozi Cooperative in this repository and its official companion repositories,
+excluding third-party components that are separately licensed.
+
+Additional Use Grant:
+
+You may make Production Use of the Licensed Work, without a separate commercial
+license from Mozi Cooperative, solely for Permitted Community Use. "Permitted
+Community Use" means:
+
+1. personal study, hobby, experimentation, academic study, classroom use,
+   public-interest research, lab work, or private evaluation;
+2. internal noncommercial use by an individual, school, university, research
+   group, nonprofit, cooperative, or community organization;
+3. operation of a private, non-public learning or research network, including
+   use with friends, classmates, collaborators, or a small local community,
+   provided that all of the following are true:
+   a. the network is not operated as a commercial product or service;
+   b. the network is not used to generate direct or indirect revenue, fees,
+      subscriptions, token-sale proceeds, or paid support obligations tied to the
+      Licensed Work;
+   c. the network is not offered to third parties as hosted infrastructure,
+      managed infrastructure, white-label infrastructure, wallet-as-a-service,
+      RPC-as-a-service, agent-as-a-service, inference-as-a-service,
+      compute-as-a-service, validator-as-a-service, or similar commercial
+      infrastructure;
+   d. the deployment remains at or below 25 nodes and 250 user accounts or
+      wallet accounts;
+   e. any fork or derivative removes or replaces Citrate, Citrate OpenWallet,
+      SALT, Mozi Cooperative, and related branding unless separately licensed in
+      writing.
+
+For clarity, the Additional Use Grant does not permit, without separate written
+permission from Mozi Cooperative:
+
+- a public production launch of a chain, network, wallet, hosted service,
+  platform, or derivative product;
+- any use in connection with a revenue-generating or fee-generating offering;
+- any production use by or for a commercial entity except as expressly allowed
+  above;
+- use of Citrate, Citrate OpenWallet, SALT, Mozi Cooperative marks, logos, or
+  confusingly similar branding;
+- offering commercial support, managed hosting, or institutional rollout
+  services built on the Licensed Work.
+
+Commercial, production, institutional, and partnership use inquiries:
+Partnerships@Citrate.ai
+
+Change Date: 2030-04-01
+
+Change License: GPL-2.0-or-later
+
+Notice on patents, trademarks, and reserved rights:
+
+This License does not grant trademark rights. See TRADEMARK_POLICY.md.
+No express or implied patent license is granted except as may be required by law.
+Certain mechanisms and designs embodied in the Licensed Work, including but not
+limited to consensus mechanisms, AI-native precompile interfaces, ZK verifiable
+compute flows, embedded-node application architecture, and agent harness
+architecture, may be the subject of filed, pending, or future patent claims or
+applications by Mozi Cooperative or its affiliates. See PATENT_NOTICE.md.
+
+---
+
+Business Source License 1.1
+
+License text copyright © 2024 MariaDB plc, All Rights Reserved. “Business Source
+License” is a trademark of MariaDB plc.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production
+use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under the
+terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements currently
+in effect as described in this License, you must purchase a commercial license
+from the Licensor, its affiliated entities, or authorized resellers, or you must
+refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work and the Change Date may vary for each
+version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy of
+the Licensed Work. If you receive the Licensed Work in original or modified form
+from a third party, the terms and conditions set forth in this License apply to
+your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other versions
+of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates (provided that you may use a trademark or logo of Licensor as
+expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license your
+works, and to refer to it using the trademark "Business Source License", as long
+as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business Source
+License" name and trademark, Licensor covenants to MariaDB, and to all other
+recipients of the licensed work to be provided by Licensor:
+
+To specify as the Change License the GPL Version 2.0 or any later version, or a
+license that is compatible with GPL Version 2.0 or a later version, where
+"compatible" means that software provided under the Change License can be
+included in a program with software provided under GPL Version 2.0 or a later
+version. Licensor may specify additional Change Licenses without limitation.
+
+To either: (a) specify an additional grant of rights to use that does not impose
+any additional restriction on the right granted in this License, as the
+Additional Use Grant; or (b) insert the text "None" to specify a Change Date. Not
+to modify this License in any other way.
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

citrate_labs_sdk-0.6.0/MANIFEST.in

@@ -0,0 +1,11 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include requirements.txt
+include pyproject.toml
+recursive-include citrate_sdk *.py *.pyi
+recursive-include citrate_sdk py.typed
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude tests *
+global-exclude .DS_Store

citrate_labs_sdk-0.6.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: citrate-labs-sdk
+Version: 0.6.0
+Summary: Non-canonical Python SDK for the Citrate distributed AI network. The canonical SDK is citrate-js (TypeScript). This Python SDK is opt-in and may lag behind the canonical SDK.
+Author-email: Citrate Team <developers@citrate.ai>
+Maintainer-email: Citrate Team <developers@citrate.ai>
+License: Apache-2.0
+Project-URL: Homepage, https://citrate.ai
+Project-URL: Documentation, https://docs.citrate.ai
+Project-URL: Repository, https://github.com/SaulBuilds/citrate
+Project-URL: Bug Tracker, https://github.com/SaulBuilds/citrate/issues
+Project-URL: Changelog, https://github.com/SaulBuilds/citrate/blob/main/CHANGELOG.md
+Keywords: citrate,distributed-ai,ai,dag,web3,machine-learning
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests~=2.33
+Requires-Dist: cryptography~=46.0
+Requires-Dist: eth-account~=0.9
+Requires-Dist: web3~=7.15
+Requires-Dist: numpy~=2.0
+Requires-Dist: typing-extensions~=4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: isort<7,>=5.13; extra == "dev"
+Requires-Dist: coverage>=7.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=8.1.3; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == "docs"
+Requires-Dist: myst-parser>=2.0; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=1.20; extra == "docs"
+Dynamic: license-file
+
+---
+created: 2026-05-18T00:18:30Z
+branch: main
+author: monorepo-split
+status: active
+split-from-monorepo-at: b3ccd5c7
+split-from-monorepo-tag: pre-split-v0.4.0
+archived-monorepo: https://github.com/CitrateNetwork/citrate-monorepo-archive
+agentile-archive: https://github.com/CitrateNetwork/citrate-agentile-archive
+---
+
+# citrate-sdk-python
+
+Python SDK for Citrate Network
+
+## Repository context
+
+This repo was split from the **Citrate monorepo** on 2026-05-18. For the full history of decisions, sprints, audits, remediations, and ADRs that led to the split, see:
+
+- **Monorepo archive**: https://github.com/CitrateNetwork/citrate-monorepo-archive — pre-split source + history (frozen)
+- **Agentile archive**: https://github.com/CitrateNetwork/citrate-agentile-archive — methodology corpus (rules, planset, sprints, audits)
+
+The source paths inside the pre-split monorepo were:
+
+```
+--path citrate_v0.01.1/sdks/python/ --path-rename citrate_v0.01.1/sdks/python/:
+```
+
+## Releases
+
+This repo versions **independently** from other CitrateNetwork repos. See GitHub Releases for tagged versions.
+
+## Contributing
+
+This repo inherits the operating rules from `CitrateNetwork/citrate-agentile-archive/rules/CORE_RULES.md`. The Agentile framework's 13 non-negotiable rules apply uniformly across all CitrateNetwork repos.
+
+## License
+
+Inherits from the monorepo. See [`LICENSE`](LICENSE) if present, or the [monorepo archive](https://github.com/CitrateNetwork/citrate-monorepo-archive/blob/main/LICENSE).

citrate_labs_sdk-0.6.0/README.md

@@ -0,0 +1,39 @@
+---
+created: 2026-05-18T00:18:30Z
+branch: main
+author: monorepo-split
+status: active
+split-from-monorepo-at: b3ccd5c7
+split-from-monorepo-tag: pre-split-v0.4.0
+archived-monorepo: https://github.com/CitrateNetwork/citrate-monorepo-archive
+agentile-archive: https://github.com/CitrateNetwork/citrate-agentile-archive
+---
+
+# citrate-sdk-python
+
+Python SDK for Citrate Network
+
+## Repository context
+
+This repo was split from the **Citrate monorepo** on 2026-05-18. For the full history of decisions, sprints, audits, remediations, and ADRs that led to the split, see:
+
+- **Monorepo archive**: https://github.com/CitrateNetwork/citrate-monorepo-archive — pre-split source + history (frozen)
+- **Agentile archive**: https://github.com/CitrateNetwork/citrate-agentile-archive — methodology corpus (rules, planset, sprints, audits)
+
+The source paths inside the pre-split monorepo were:
+
+```
+--path citrate_v0.01.1/sdks/python/ --path-rename citrate_v0.01.1/sdks/python/:
+```
+
+## Releases
+
+This repo versions **independently** from other CitrateNetwork repos. See GitHub Releases for tagged versions.
+
+## Contributing
+
+This repo inherits the operating rules from `CitrateNetwork/citrate-agentile-archive/rules/CORE_RULES.md`. The Agentile framework's 13 non-negotiable rules apply uniformly across all CitrateNetwork repos.
+
+## License
+
+Inherits from the monorepo. See [`LICENSE`](LICENSE) if present, or the [monorepo archive](https://github.com/CitrateNetwork/citrate-monorepo-archive/blob/main/LICENSE).

citrate_labs_sdk-0.6.0/citrate_labs_sdk.egg-info/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: citrate-labs-sdk
+Version: 0.6.0
+Summary: Non-canonical Python SDK for the Citrate distributed AI network. The canonical SDK is citrate-js (TypeScript). This Python SDK is opt-in and may lag behind the canonical SDK.
+Author-email: Citrate Team <developers@citrate.ai>
+Maintainer-email: Citrate Team <developers@citrate.ai>
+License: Apache-2.0
+Project-URL: Homepage, https://citrate.ai
+Project-URL: Documentation, https://docs.citrate.ai
+Project-URL: Repository, https://github.com/SaulBuilds/citrate
+Project-URL: Bug Tracker, https://github.com/SaulBuilds/citrate/issues
+Project-URL: Changelog, https://github.com/SaulBuilds/citrate/blob/main/CHANGELOG.md
+Keywords: citrate,distributed-ai,ai,dag,web3,machine-learning
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests~=2.33
+Requires-Dist: cryptography~=46.0
+Requires-Dist: eth-account~=0.9
+Requires-Dist: web3~=7.15
+Requires-Dist: numpy~=2.0
+Requires-Dist: typing-extensions~=4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: isort<7,>=5.13; extra == "dev"
+Requires-Dist: coverage>=7.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=8.1.3; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == "docs"
+Requires-Dist: myst-parser>=2.0; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=1.20; extra == "docs"
+Dynamic: license-file
+
+---
+created: 2026-05-18T00:18:30Z
+branch: main
+author: monorepo-split
+status: active
+split-from-monorepo-at: b3ccd5c7
+split-from-monorepo-tag: pre-split-v0.4.0
+archived-monorepo: https://github.com/CitrateNetwork/citrate-monorepo-archive
+agentile-archive: https://github.com/CitrateNetwork/citrate-agentile-archive
+---
+
+# citrate-sdk-python
+
+Python SDK for Citrate Network
+
+## Repository context
+
+This repo was split from the **Citrate monorepo** on 2026-05-18. For the full history of decisions, sprints, audits, remediations, and ADRs that led to the split, see:
+
+- **Monorepo archive**: https://github.com/CitrateNetwork/citrate-monorepo-archive — pre-split source + history (frozen)
+- **Agentile archive**: https://github.com/CitrateNetwork/citrate-agentile-archive — methodology corpus (rules, planset, sprints, audits)
+
+The source paths inside the pre-split monorepo were:
+
+```
+--path citrate_v0.01.1/sdks/python/ --path-rename citrate_v0.01.1/sdks/python/:
+```
+
+## Releases
+
+This repo versions **independently** from other CitrateNetwork repos. See GitHub Releases for tagged versions.
+
+## Contributing
+
+This repo inherits the operating rules from `CitrateNetwork/citrate-agentile-archive/rules/CORE_RULES.md`. The Agentile framework's 13 non-negotiable rules apply uniformly across all CitrateNetwork repos.
+
+## License
+
+Inherits from the monorepo. See [`LICENSE`](LICENSE) if present, or the [monorepo archive](https://github.com/CitrateNetwork/citrate-monorepo-archive/blob/main/LICENSE).

citrate_labs_sdk-0.6.0/citrate_labs_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,44 @@
+CHANGELOG.md
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+citrate_labs_sdk.egg-info/PKG-INFO
+citrate_labs_sdk.egg-info/SOURCES.txt
+citrate_labs_sdk.egg-info/dependency_links.txt
+citrate_labs_sdk.egg-info/entry_points.txt
+citrate_labs_sdk.egg-info/requires.txt
+citrate_labs_sdk.egg-info/top_level.txt
+citrate_sdk/__init__.py
+citrate_sdk/_url_security.py
+citrate_sdk/abi.py
+citrate_sdk/cli.py
+citrate_sdk/client.py
+citrate_sdk/compute.py
+citrate_sdk/crypto.py
+citrate_sdk/ecdh_real.py
+citrate_sdk/entitlements.py
+citrate_sdk/errors.py
+citrate_sdk/farming.py
+citrate_sdk/finite_field.py
+citrate_sdk/gateway.py
+citrate_sdk/ipfs.py
+citrate_sdk/learning.py
+citrate_sdk/models.py
+citrate_sdk/py.typed
+citrate_sdk/treasury.py
+citrate_sdk/types.py
+citrate_sdk/_generated/__init__.py
+citrate_sdk/_generated/contract.py
+citrate_sdk/_generated/federation_contract.json
+citrate_sdk/economics/__init__.py
+citrate_sdk/economics/agents.py
+citrate_sdk/economics/charts.py
+citrate_sdk/economics/parameters.py
+citrate_sdk/economics/simulation.py
+citrate_sdk/edu/__init__.py
+citrate_sdk/identity/__init__.py
+citrate_sdk/identity/client.py
+citrate_sdk/identity/jwt.py
+citrate_sdk/identity/pkce.py
+citrate_sdk/identity/wallet.py

citrate_labs_sdk-0.6.0/citrate_labs_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

citrate_labs_sdk-0.6.0/citrate_labs_sdk.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+citrate = citrate_sdk.cli:main

citrate_labs_sdk-0.6.0/citrate_labs_sdk.egg-info/requires.txt

@@ -0,0 +1,21 @@
+requests~=2.33
+cryptography~=46.0
+eth-account~=0.9
+web3~=7.15
+numpy~=2.0
+typing-extensions~=4.0
+
+[dev]
+pytest>=7.0
+pytest-asyncio>=0.21
+black>=23.0
+ruff>=0.1.0
+mypy>=1.0
+isort<7,>=5.13
+coverage>=7.0
+
+[docs]
+sphinx>=8.1.3
+sphinx-rtd-theme>=1.0
+myst-parser>=2.0
+sphinx-autodoc-typehints>=1.20

citrate_labs_sdk-0.6.0/citrate_labs_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+citrate_sdk

citrate_labs_sdk-0.6.0/citrate_sdk/__init__.py

@@ -0,0 +1,81 @@
+"""
+Citrate Python SDK
+
+A comprehensive Python SDK for interacting with the Citrate AI blockchain platform.
+Provides easy-to-use interfaces for model deployment, inference execution,
+encryption, access control, payment systems, learning pools, liquid staking,
+classrooms, compute marketplace, treasury, and farming operations.
+"""
+
+from .client import CitrateClient
+from .models import ModelConfig, ModelDeployment, InferenceRequest, InferenceResult, ModelType, AccessType
+from .crypto import EncryptionConfig, KeyManager
+from .errors import CitrateError, ModelNotFoundError, InsufficientFundsError
+
+# LC.5.3: Learning / Staking / Classroom managers
+from .learning import LearningManager, StakingManager, ClassroomManager
+
+# COMPUTE-4: Compute marketplace manager
+from .compute import ComputeManager
+
+# ECON-2: Treasury and farming managers
+from .treasury import TreasuryManager
+from .farming import FarmingManager
+
+# Shared data types for learning / staking / classroom / compute
+from .types import (
+    LearningPool,
+    CycleStatus,
+    Contributions,
+    ContributionDetail,
+    StakingInfo,
+    PendingWithdrawal,
+    ClassroomInfo,
+    ComputeJob,
+    ProviderInfo,
+    ComputePool,
+    Dispute,
+)
+
+__version__ = "0.5.0"
+__author__ = "Citrate Team"
+
+__all__ = [
+    # Core client
+    "CitrateClient",
+    # Model types
+    "ModelConfig",
+    "ModelDeployment",
+    "InferenceRequest",
+    "InferenceResult",
+    "ModelType",
+    "AccessType",
+    # Crypto
+    "EncryptionConfig",
+    "KeyManager",
+    # Errors
+    "CitrateError",
+    "ModelNotFoundError",
+    "InsufficientFundsError",
+    # LC.5.3: Learning managers
+    "LearningManager",
+    "StakingManager",
+    "ClassroomManager",
+    # COMPUTE-4: Compute manager
+    "ComputeManager",
+    # ECON-2: Treasury and farming managers
+    "TreasuryManager",
+    "FarmingManager",
+    # Data types
+    "LearningPool",
+    "CycleStatus",
+    "Contributions",
+    "ContributionDetail",
+    "StakingInfo",
+    "PendingWithdrawal",
+    "ClassroomInfo",
+    "ComputeJob",
+    "ProviderInfo",
+    "ComputePool",
+    "Dispute",
+]

citrate_labs_sdk-0.6.0/citrate_sdk/_generated/contract.py

@@ -0,0 +1,68 @@
+"""Typed accessor over the vendored federation contract artifact (DEVX-S0, ADR-0001).
+
+The single source of truth for chain addresses, chainId, endpoints, and the
+entitlement tier vocabulary. Do NOT hand-edit ``federation_contract.json`` — it is
+synced from ``citrate-federation/contract/federation-contract.json`` via
+``python scripts/sync_contract.py``, which is generated from
+``citrate-chain/contracts/addresses/40204.json`` + ``citrate-identity``.
+"""
+from __future__ import annotations
+
+import json
+from functools import lru_cache
+from pathlib import Path
+from typing import Any, Dict, List
+
+_ARTIFACT = Path(__file__).with_name("federation_contract.json")
+
+
+@lru_cache(maxsize=1)
+def federation_contract() -> Dict[str, Any]:
+    """Return the full contract artifact as a dict."""
+    return json.loads(_ARTIFACT.read_text(encoding="utf-8"))
+
+
+def chain_id() -> int:
+    return int(federation_contract()["chain"]["chainId"])
+
+
+def rpc_url() -> str:
+    return str(federation_contract()["chain"]["rpcUrl"])
+
+
+def ws_url() -> str:
+    return str(federation_contract()["chain"]["wsUrl"])
+
+
+def aa_stack() -> Dict[str, str]:
+    """ERC-4337 account-abstraction stack addresses (EntryPoint, factory, paymaster, …)."""
+    return dict(federation_contract()["aaStack"])
+
+
+def contracts() -> Dict[str, str]:
+    return dict(federation_contract()["contracts"])
+
+
+def membership() -> Dict[str, Any]:
+    return dict(federation_contract()["membership"])
+
+
+def precompiles() -> Dict[str, str]:
+    return dict(federation_contract()["precompiles"])
+
+
+def identity() -> Dict[str, Any]:
+    """OIDC issuer/discovery/jwks/scopes + the entitlement claim URI."""
+    return dict(federation_contract()["identity"])
+
+
+def gateway() -> Dict[str, str]:
+    return dict(federation_contract()["gateway"])
+
+
+def entitlement_tiers() -> List[str]:
+    return list(federation_contract()["entitlements"]["tiers"])
+
+
+def kyc_baseline_tier() -> str:
+    return str(federation_contract()["entitlements"]["kycBaselineTier"])