treasury

type Account struct {
	OrgID   string
	Address string // 0x-prefixed, lowercased for stable indexing/matching
	// contains filtered or unexported fields
}

type Bucket string

type Issuance struct {
	Id      string `json:"id"`
	IdemKey string `json:"idemKey"`
	OrgID   string `json:"orgId"`
	// Subject is the off-chain ledger DestinationId this mint credits (an IAM
	// "owner/name" per-user key, or the org slug for org-pooled billing). On-chain
	// HUSD is per-ORG (one derived address per OrgID), so many subjects share one
	// address; Subject records which sub-ledger the projected credit lands in.
	// Defaults to OrgID (org-pooled) when the caller leaves it empty.
	Subject     string `json:"subject"`
	OrgAddress  string `json:"orgAddress"`
	AmountCents int64  `json:"amountCents"`
	Bucket      Bucket `json:"bucket"`
	Reason      string `json:"reason"`
	// Test marks a mint on the test chain (matches the ledger's Test partition so
	// the balance read finds it). A test-mode org mints test HUSD; a live org mints
	// live HUSD — the projected credit's Test flag MUST equal the balance read's.
	Test      bool           `json:"test"`
	ChainID   int64          `json:"chainId"`
	TokenAddr string         `json:"tokenAddr"`
	TxHash    string         `json:"txHash,omitempty"`
	Status    IssuanceStatus `json:"status"`
	CreatedAt time.Time      `json:"createdAt"`
	MintedAt  time.Time      `json:"mintedAt,omitempty"`
}

type IssuanceStatus string

type IssuanceStore interface {
	// CreateIfAbsent records iss iff its Id is not already present. Returns
	// created==true with iss when this call created it, or created==false with the
	// pre-existing record otherwise. Exactly one concurrent caller sees created==true.
	CreateIfAbsent(ctx context.Context, iss *Issuance) (created bool, existing *Issuance, err error)
	// Update persists status/txHash/mintedAt on an existing issuance.
	Update(ctx context.Context, iss *Issuance) error
	// Get loads an issuance by id (nil,nil if absent).
	Get(ctx context.Context, id string) (*Issuance, error)
}

type MintRequest struct {
	OrgID string
	// Subject is the ledger DestinationId to credit (defaults to OrgID when empty —
	// org-pooled billing). See Issuance.Subject.
	Subject     string
	AmountCents int64
	Bucket      Bucket
	Reason      string
	IdemKey     string
	// Test routes the mint to the test partition of the ledger (must match the
	// balance read's Test flag). Set from org.TestMode() by the caller.
	Test bool
}

type Option func(*Treasury)

type Receipt struct {
	IdemKey     string
	OrgID       string
	Subject     string
	OrgAddress  string
	AmountCents int64
	Bucket      Bucket
	Reason      string
	Test        bool
	ChainID     int64
	TxHash      string
	Replayed    bool // true if the key had already minted; no new tx was sent
}

type TransferFunc func(ctx context.Context, t blockchain.TokenTransfer) (string, error)

type Treasury struct {
	// contains filtered or unexported fields
}