playmos 0.1.0a1

Playmos SDK for Python — REST client for Base Sepolia sandbox (IAP verify/pay, agents, transfers). Server-side secrets only. No web3 signing.

playmos (Python) — 0.1.0a1

Thin REST client for the Playmos sandbox API on Base Sepolia.
Mirrors Playmos.Sdk (C#) / server half of the SDK. No web3 signing. No crypto UX.

Testnet only. Mainnet is not available yet.
Never put sk_test_ in a game client or browser. Use this package on your game server.

Install

pip install playmos==0.1.0a1
# after PyPI publish (tag py-v0.1.0a1)

Dev from monorepo:

cd python
pip install -e ".[dev]"
pytest

Quickstart — verify then grant

import os
from playmos import PlaymosClient

# SERVER only — secret key
client = PlaymosClient(os.environ["PLAYMOS_SECRET"])  # sk_test_…

p = client.verify(payment_id)
if p.is_confirmed:
    grant_item(p.player_id, p.sku)

Sandbox server-settle pay (pk_test_ only)

from playmos import PlaymosClient

client = PlaymosClient.for_sandbox_public_key()
payment = client.pay("0.99", "gems_500", "player_abc")
# payment.status == "confirmed"; open payment.tx_hash on sepolia.basescan.org

Agents + transfer (sk_test_)

from playmos import PlaymosClient

client = PlaymosClient.for_agent_sandbox_key()  # testnet only, still server-side
a = client.create_wallet("npc_miner")
client.fund(a.agent_id, "0.50")
client.transfer(to="npc_shop", amount="0.10", from_=a.agent_id, fee_bps=0)

Surfaces

Method	Key	Purpose
verify	pk or sk	Verify before grant
pay	pk_test_ only	Server-settle IAP
create_wallet / fund	sk_test_	NPC wallets + faucet
transfer / get_transfer	sk_test_ for NPC from	USDC transfer
get_prize	studio key	Claimable read (withdraw = player-signed JS)

429 retry

Default ON (max_retries=2). Opt out: RetryOptions.disabled().

Security

Key	Where
pk_test_playmos_sandbox	Sandbox pay demos
sk_test_…	Server only
Game client	No secrets

Issues

Parent #76 · this phase #81