Skip to main content

gatecore-sdk

gatecore-sdk is GateCore's Python client SDK. It builds a GateCore interaction request, signs it with an Ed25519 private key, and submits it to a GateCore gateway for governed execution. The SDK contains transport and signing only; GateCore services enforce identity, policy, trust, provenance, pricing, funding, delegation, and settlement.

Install from the GateCore monorepo

python -m pip install -e ./libs/sdk

Usage

from gatecore_sdk import GateCoreClient

client = GateCoreClient("https://api.example.com", bearer_token="...")

req = client.build_request(
    origin_entity_id="agent:example",
    target_type="tool",
    target_id="example-tool",
    operation="tool_call",
    payload={"query": "example"},
)
signed = client.sign_request(req, private_key_pem=open("/secure/path/agent-key.pem").read())
decision = client.execute(signed)

build_request auto-attaches provenance.payload_sha256, matching the provenance engine's canonicalization exactly. sign_request signs the canonical request payload with an Ed25519 private key (PEM, PKCS8). mediate() builds, optionally signs, and posts to /v1/mediate in one call; execute() posts an already-signed request to /v1/execute.

Note on internal module layout

The SDK's signing/transport implementation lives at gatecore_sdk._common (private — not part of the public API; import GateCoreClient from gatecore_sdk directly, as shown above). An earlier working copy of this package exposed the same code as a separate top-level gatecore_common module. That name was never published to PyPI, so this rename has no external-consumer impact; it exists to avoid a published package claiming a second, overly generic top-level import name (gatecore_common) alongside gatecore_sdk.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gatecore_sdk-0.1.0.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gatecore_sdk-0.1.0-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

Details for the file gatecore_sdk-0.1.0.tar.gz.

File metadata

  • Download URL: gatecore_sdk-0.1.0.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gatecore_sdk-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d083879a68121a1fbd03d305208a2189cc210204fe982fa6ab65a45afe5d63c0
MD5 7e196c16830879097a7974d8b59b662e
BLAKE2b-256 5cd81186442999f987cf3f2176a2c639c1b3481716c00be3108fb14917cd1c17

See more details on using hashes here.

Provenance

The following attestation bundles were made for gatecore_sdk-0.1.0.tar.gz:

Publisher: publish-pypi.yml on GateCoreAI-com/GateCoreAI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file gatecore_sdk-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: gatecore_sdk-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gatecore_sdk-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7922c44a966f88a0c607a17402e83e51ccce4316bd81acdf1d6fbbd394bacb25
MD5 280f3e6e22408355074c357c74ab3ef0
BLAKE2b-256 73add15ae1c1abcbcd4a72003dc6f2c404d6590e06f206c7e76ecd7b8b446e83

See more details on using hashes here.

Provenance

The following attestation bundles were made for gatecore_sdk-0.1.0-py3-none-any.whl:

Publisher: publish-pypi.yml on GateCoreAI-com/GateCoreAI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page