mirror of
https://github.com/hanzoai/commerce.git
synced 2026-10-30 15:08:42 +00:00
Zach Kelling
098f89edfc
The owner's call, 2026-10-30: USDC through Circle Gateway is Circle's own SDK (@circle-fin/x402-batching) in Hanzo's x402 gateway in front of cloud, a deposit into Gateway once and a payment per request. The Go rail reimplemented that protocol, so it goes now rather than later: billing/gateway, payment/providers/circle, models/remittance, the three /v1/billing/crypto/gateway routes, the commerce treasury route, and the gateway networks in /v1/billing/crypto/options. Crypto top-ups by authorization pause until the gateway takes them; the deposit-address rail is unchanged. Hashid kinds 292 and 293 stay taken. Testing: go build ./... and vet clean; api/billing's crypto tests pass (TestPlanAtInterval and TestSubscribeTrial_NoChargeCardVaultedTrialing fail on main without this change too). Risk: removes a live payment route; cloud must drop its plane ops in the release that pins this. How to revert: revert this commit.
240 lines
8.0 KiB
Go
240 lines
8.0 KiB
Go
package hashid
|
|
|
|
import "fmt"
|
|
|
|
// DO NOT ALPHABETIZE THESE OR ALTER IN ANYWAY
|
|
var kinds = map[string]int{
|
|
"bundle": 0,
|
|
"campaign": 1,
|
|
"collection": 2,
|
|
"coupon": 3,
|
|
"namespace": 4,
|
|
"order": 5,
|
|
"organization": 6,
|
|
"payment": 7,
|
|
"plan": 8,
|
|
"analyticsevent": 9,
|
|
"product": 10,
|
|
"store": 11,
|
|
"token": 12,
|
|
"user": 13,
|
|
"variant": 14,
|
|
"form": 15,
|
|
"subscriber": 16,
|
|
"referral": 17,
|
|
"referrer": 18,
|
|
"transaction": 19,
|
|
"funnel": 20,
|
|
"aggregate": 21,
|
|
"site": 22,
|
|
"deploy": 23,
|
|
"submission": 24,
|
|
"subscription": 25,
|
|
"cart": 31,
|
|
"affiliate": 32,
|
|
"fee": 33,
|
|
"transfer": 34,
|
|
"reversal": 35,
|
|
"partner": 36,
|
|
"discount": 37,
|
|
"webhook": 38,
|
|
"referralprogram": 39,
|
|
"review": 40,
|
|
"return": 41,
|
|
"note": 42,
|
|
"analyticsidentifier": 43,
|
|
"taxrates": 44,
|
|
"shippingrates": 45,
|
|
"oauthtoken": 46,
|
|
"app": 47,
|
|
"wallet": 48,
|
|
"tokensale": 49,
|
|
"adcampaign": 50,
|
|
"adconfig": 51,
|
|
"adset": 52,
|
|
"ad": 53,
|
|
"copy": 54,
|
|
"media": 55,
|
|
"block": 56,
|
|
"blockaddress": 57,
|
|
"blocktransaction": 58,
|
|
"paymentmethod": 60,
|
|
|
|
// virtual kind used for making ancestor keys to force data synchronization
|
|
"synckey": 59,
|
|
"tokentransaction": 100,
|
|
"disclosure": 101,
|
|
"movie": 200,
|
|
"watchlist": 201,
|
|
"meter": 202,
|
|
// A per-unit price. Distinct from "meter" (202), which is an event
|
|
// aggregation rule — what to count — where this is what one unit costs.
|
|
"rate": 291,
|
|
"credit-grant": 203,
|
|
|
|
// Billing & commerce entities added for ORM compatibility
|
|
"meter-event": 204,
|
|
"billing-pricing-rule": 205,
|
|
"billing-event": 206,
|
|
"billing-invoice": 207,
|
|
"billing-payout": 208,
|
|
"balance-transaction": 209,
|
|
"bank-transfer-instruction": 210,
|
|
"credit-note": 211,
|
|
"customer-balance": 212,
|
|
"dispute": 213,
|
|
"payment-intent": 214,
|
|
"refund": 215,
|
|
"spend-alert": 216,
|
|
"webhook-endpoint": 217,
|
|
"network-token": 218,
|
|
"crypto-balance": 219,
|
|
"crypto-payment-intent": 220,
|
|
"usage-watermark": 221,
|
|
"setup-intent": 222,
|
|
"notification": 223,
|
|
"apipermission": 224,
|
|
"applicationmethod": 225,
|
|
"campaignbudget": 226,
|
|
"contributor": 227,
|
|
"customergroup": 228,
|
|
"customergroupmembership": 229,
|
|
"fulfillment": 230,
|
|
"fulfillmentprovider": 231,
|
|
"fulfillmentset": 232,
|
|
"geozone": 233,
|
|
"inventoryitem": 234,
|
|
"inventorylevel": 235,
|
|
"price": 236,
|
|
"pricelist": 237,
|
|
"pricepreference": 238,
|
|
"pricerule": 239,
|
|
"priceset": 240,
|
|
"promotion": 241,
|
|
"promotionrule": 242,
|
|
"publishableapikey": 243,
|
|
"redemption": 244,
|
|
"region": 245,
|
|
"reservation": 246,
|
|
"role": 247,
|
|
"saleschannel": 248,
|
|
"sbom-entry": 249,
|
|
"servicezone": 250,
|
|
"shippingoption": 251,
|
|
"shippingoptionrule": 252,
|
|
"shippingprofile": 253,
|
|
"stocklocation": 254,
|
|
"taxprovider": 255,
|
|
"taxrate": 256,
|
|
"taxraterule": 257,
|
|
"taxregion": 258,
|
|
"variantinventorylink": 259,
|
|
"subscription-item": 260,
|
|
"subscription-schedule": 261,
|
|
"sbom-record": 262,
|
|
"oss-accrual": 263,
|
|
|
|
// B2B commerce (Hanzo-native; not in Medusa v2 core — that lives in the
|
|
// medusa-starter-b2b recipe). company → employees (spending limits) →
|
|
// quotes (RFQ) → approvals (spend gating).
|
|
"company": 264,
|
|
"employee": 265,
|
|
"quote": 266,
|
|
"quote-message": 267,
|
|
"approval": 268,
|
|
|
|
// Gift cards (Hanzo-native; removed from Medusa v2 core, present in v1).
|
|
// Redemptions are an append-only ledger; balance is a projection.
|
|
"gift-card": 269,
|
|
"gift-card-redemption": 270,
|
|
|
|
// Order exchange (Medusa v2 core parity: api/admin/exchanges) — a return
|
|
// of inbound items paired with outbound replacement items.
|
|
"exchange": 271,
|
|
|
|
// Reusable idempotency guard for money-moving requests (refund/capture).
|
|
"idempotency-key": 272,
|
|
|
|
// Platform product catalog (CMS SOT for Hanzo's own products — the catalog
|
|
// docs.hanzo.ai + console + pricing derive from). Brand/category-scoped.
|
|
"catalog-entry": 273,
|
|
|
|
// Product builder taxonomy (Medusa v2 parity: product-options/values as
|
|
// first-class admin entities; categories/tags/types for organization).
|
|
"product-option": 274,
|
|
"product-option-value": 275,
|
|
"product-category": 276,
|
|
"product-tag": 277,
|
|
"product-type": 278,
|
|
|
|
// Order reason lookups (Medusa: return-reasons / refund-reasons).
|
|
"return-reason": 279,
|
|
"refund-reason": 280,
|
|
|
|
// Chain-backed credit ledger (HUSD on the Hanzo EVM). husd-issuance is the
|
|
// off-chain idempotent record of ONE treasury mint (deterministic-id keyed
|
|
// on the idempotency key); its TxHash is the on-chain audit anchor.
|
|
"husd-issuance": 281,
|
|
// husd-cursor: the indexer's last fully-scanned block (per chain), so a
|
|
// restart resumes rather than rescans. husd-settlement: the idempotent record
|
|
// of ONE org→treasury settlement window (metered usage swept back on chain).
|
|
"husd-cursor": 282,
|
|
"husd-settlement": 283,
|
|
|
|
// commerce-invite: a platform-minted invite code that grants ONE org
|
|
// subscription-free access to the commerce admin (the paywall's third allow
|
|
// path, alongside an active/trialing subscription and live trial credit). A
|
|
// global (system-namespace) directory keyed by code; first-touch redeem binds
|
|
// the code to the redeeming org, idempotently.
|
|
"commerce-invite": 284,
|
|
|
|
// Medusa-parity domains (admin order builder, order claims, currency entity).
|
|
// Monotonic — never reorder. draft-order → admin builds an order for a customer
|
|
// with line items, then converts it to a real order; claim → damaged/wrong-item
|
|
// resolution (refund|replace); currency → the currency entity (was a bare string).
|
|
"draft-order": 285,
|
|
"draft-order-item": 286,
|
|
"claim": 287,
|
|
"claim-item": 288,
|
|
"currency": 289,
|
|
|
|
// auto-recharge — the per-org off-session top-up config. The model has
|
|
// registered this kind with the ORM since it was written
|
|
// (models/autorecharge: orm.Register[AutoRecharge]("auto-recharge")) but was
|
|
// never added here, so Create() hit encodeKind's panic: enabling
|
|
// auto-recharge for the first time (PUT /v1/billing/recharge, which
|
|
// Creates when no row exists) was a hard 500. Updating an existing row never
|
|
// touched this path, which is why it survived — there was no way to get a
|
|
// first row in.
|
|
"auto-recharge": 290,
|
|
|
|
// remittance — the retired Circle Gateway top-up rail's record (deleted
|
|
// 2026-10-30). The numbers stay taken: a kind number is never reused.
|
|
"remittance": 292,
|
|
"remittance-hold": 293,
|
|
}
|
|
|
|
var kindsReversed = make(map[int]string)
|
|
|
|
func init() {
|
|
for k, v := range kinds {
|
|
kindsReversed[v] = k
|
|
}
|
|
}
|
|
|
|
func encodeKind(kind string) int {
|
|
if encoded, ok := kinds[kind]; ok {
|
|
return encoded
|
|
} else {
|
|
panic(fmt.Sprintf("Unknown kind '%s', register in util/hashid/kind.go", kind))
|
|
}
|
|
}
|
|
|
|
func decodeKind(encoded int) (string, error) {
|
|
if kind, ok := kindsReversed[encoded]; ok {
|
|
return kind, nil
|
|
} else {
|
|
return "", fmt.Errorf("Unknown encoded kind '%d', register in util/hashid/kind.go", encoded)
|
|
}
|
|
}
|