escrow_v3 source realm

 1const (
 2	// No authority address is compiled in. admin.gno seeds the live `admin` and
 3	// the fee fail-safe `feeFallback` from the publishing transaction's signer at
 4	// package load (on gnoland-1 the samcrew namespace multisig, the stamped
 5	// creator at enable time); admin is rotated via TransferOwnership/
 6	// AcceptOwnership. Do not compare a caller against a constant: on mainnet a
 7	// compile-time authority is unrecoverable (immutable realm, no faucet).
 8	// PlatformFeePct is now only the FAIL-SAFE fallback bps source (see resolveFee) —
 9	// the live path reads cfg.GetFeeBPS(laneService). Kept as a 0-100 percent (not bps)
10	// for backward-compat readability; resolveFee converts it.
11	PlatformFeePct = 2 // 2% fallback only
12	CancelFeePct   = 5 // 5% cancellation fee — escrow-internal, NOT on the fee spine
13	// (paid to the freelancer as compensation, not a protocol fee)
14	AutoRefundBlks     = int64(864000) // ~30 days at 3s/block
15	AutoResolveBlks    = int64(806400) // ~28 days at 3s/block
16	MaxTitleLen        = 200
17	MaxDescLen         = 5000
18	MaxMilestones      = 20
19	MaxContracts       = 500
20	MinMilestoneAmount = int64(1000) // 0.001 GNOT — prevents fee evasion via truncation
21)

1const (
2	StatusActive    ContractStatus = "active"
3	StatusCompleted ContractStatus = "completed"
4	StatusDisputed  ContractStatus = "disputed"
5	StatusCancelled ContractStatus = "cancelled"
6)

1const (
2	MsPending   MilestoneStatus = "pending"
3	MsFunded    MilestoneStatus = "funded"
4	MsCompleted MilestoneStatus = "completed"
5	MsReleased  MilestoneStatus = "released"
6	MsDisputed  MilestoneStatus = "disputed"
7	MsRefunded  MilestoneStatus = "refunded"
8)

1func AcceptOwnership(cur realm)

1func CancelContract(cur realm, contractId string)

1func CancelOwnershipTransfer(cur realm)

1func ClaimDisputeTimeout(cur realm, contractId string, milestoneIdx int)

1func ClaimRefund(cur realm, contractId string, milestoneIdx int)

1func CompleteMilestone(cur realm, contractId string, milestoneIdx int)

1func CreateContract(cur realm, freelancer address, title, description, milestones string) string

1func FundMilestone(cur realm, contractId string, milestoneIdx int)

1func GetAdmin() string

1func GetPendingAdmin() string

1func IsPaused() bool

1func Pause(cur realm)

1func RaiseDispute(cur realm, contractId string, milestoneIdx int)

1func RealmAddress() string

1func ReleaseFunds(cur realm, contractId string, milestoneIdx int)

1func Render(path string) string

1func ResolveDispute(cur realm, contractId string, milestoneIdx int, refundClient bool)

1func TotalLiabilities() int64

1func TransferOwnership(cur realm, newAdmin address)

1func Unpause(cur realm)

1func GetGovernanceContract(id string) GovernanceContract

1func GetGovernanceFeeTerms() GovernanceFeeTerms

 1type Contract struct {
 2	ID          string
 3	Client      address
 4	Freelancer  address
 5	Title       string
 6	Description string
 7	Status      ContractStatus
 8	CreatedAt   int64 // block height
 9	Milestones  []Milestone
10}

1type ContractStatus string

1type GovernanceContract struct {
2	Exists                  bool
3	ID, ContentHash, Status string
4	Client, Freelancer      address
5	Count                   int
6	Milestones              [20]GovernanceMilestone
7}

1type GovernanceFeeTerms struct {
2	RawBPS, EffectiveBPS                             int64
3	RawTreasury, FallbackTreasury, EffectiveTreasury address
4}

1type GovernanceMilestone struct {
2	ID                                int
3	Amount                            int64
4	Status                            string
5	FundedAt, CompletedAt, DisputedAt int64
6	PreDisputeStatus                  string
7}

 1type Milestone struct {
 2	ID               int
 3	Title            string
 4	Amount           int64 // ugnot
 5	Status           MilestoneStatus
 6	FundedAt         int64           // block height (0 if not funded)
 7	CompletedAt      int64           // block height (0 if not completed)
 8	DisputedAt       int64           // block height (0 if not disputed)
 9	PreDisputeStatus MilestoneStatus // status before dispute (MsFunded or MsCompleted)
10}

1type MilestoneStatus string