enact-protocol

pip install enact-protocol

import asyncio
from enact_protocol import EnactClient

async def main():
    async with EnactClient(api_key="YOUR_TONCENTER_KEY") as client:
        # List all TON jobs
        jobs = await client.list_jobs()
        print(f"{len(jobs)} jobs on ENACT Protocol")

        # Get job details
        status = await client.get_job_status(jobs[0].address)
        print(status.state_name, status.budget_ton)

        # List USDT jobs
        jetton_jobs = await client.list_jetton_jobs()

asyncio.run(main())

import asyncio
from enact_protocol import EnactClient, CreateJobParams

async def main():
    async with EnactClient(
        mnemonic="your 24 words here",
        pinata_jwt="optional_for_ipfs",
        api_key="YOUR_TONCENTER_KEY",
    ) as client:
        # Create and fund a TON job
        job_addr = await client.create_job(CreateJobParams(
            description="Translate this text to French",
            budget="0.1",
            evaluator="UQ...",
            timeout=86400,
        ))
        await client.fund_job(job_addr)

        # Provider flow
        await client.take_job(job_addr)
        await client.submit_result(job_addr, "Voici la traduction...")

        # Evaluator flow
        await client.evaluate_job(job_addr, approved=True, reason="Good translation")

asyncio.run(main())

# (snippets below run inside an async function, e.g. the main() above)
from pathlib import Path
from enact_protocol import CreateJobParams

# Create job with attached file
brief = Path("brief.png").read_bytes()
job_addr = await client.create_job(CreateJobParams(
    description="Review this design",
    budget="0.1",
    evaluator="UQ...",
    file=(brief, "brief.png"),
))

# Submit result with file
result_pdf = Path("result.pdf").read_bytes()
await client.submit_result(job_addr, "Design completed", file=(result_pdf, "result.pdf"))

# (inside an async function)
# Get public keys from on-chain wallet state
client_pub = await client.get_wallet_public_key(status.client)
evaluator_pub = await client.get_wallet_public_key(status.evaluator)

# Submit encrypted result
await client.submit_encrypted_result(
    job_addr,
    "Sensitive data...",
    recipient_public_keys={"client": client_pub, "evaluator": evaluator_pub},
)

# Decrypt (client or evaluator only)
from enact_protocol import EncryptedEnvelope
envelope = EncryptedEnvelope.model_validate_json(ipfs_json)
plaintext = await client.decrypt_job_result(envelope, role="client")

# (inside an async function)
job_addr = await client.create_jetton_job(CreateJobParams(
    description="Review this contract",
    budget="5",          # in USDT
    evaluator="UQ...",
))
await client.set_jetton_wallet(job_addr)
await client.fund_jetton_job(job_addr)

client = EnactClient(
    endpoint="https://toncenter.com/api/v2/jsonRPC",
    api_key="your_key",
)

from enact_protocol.wrappers import (
    build_factory_message,
    build_job_message,
    build_jetton_transfer_message,
    build_set_jetton_wallet_message,
)