mirror of
https://github.com/luxfi/node.git
synced 2026-07-27 03:39:39 +00:00
External (HTTP / JSON-RPC) is the only place JSON is legitimate. Every
existing encoding/json import in node/ moves to github.com/go-json-experiment/json
(v2 root, not the v1 sub-package). NewEncoder/NewDecoder rewrite to
MarshalWrite/UnmarshalRead. MarshalIndent rewrites to Marshal with
jsontext.WithIndent. json.RawMessage rewrites to jsontext.Value.
*json.SyntaxError rewrites to *jsontext.SyntacticError.
81 files migrated. LLM.md captures the rule + v1->v2 delta table.
Known v2 semantic deltas surfaced by existing tests (followups, not regressions):
- [N]byte fields with no MarshalJSON now marshal as base64 string (v1 marshalled
as JSON array of byte numbers). Affects vms/platformvm/txs/*_test.go fixtures
with embedded BLS proofOfPossession.
- time.Duration has no v2 default representation; configs that wire-format
Duration as nanoseconds (vms/{xvm,platformvm}/config, config/spec) need to
switch to string-form Duration or carry an explicit option. v2 root does not
re-export FormatDurationAsNano.
- v2 enforces strict UTF-8 (vms/chainadapter/messaging fixture has non-UTF-8).
- json.MarshalWrite does not append a trailing '\n' (v1 NewEncoder.Encode did);
service/auth/auth_test.go expectation updated.
- nil []byte round-trips to empty (not nil); config_test deep-equal fixtures
surface this.
All affected sites are at the API boundary; ZAP wire envelope already covers
the internal data paths (state, P2P, consensus, MPC, threshold). Internal
JSON sites that should move to ZAP next (separate work):
- vms/da/store.go (DA blob/cert storage as JSON)
- vms/platformvm/airdrop (airdrop claims as JSON in db)
- vms/chainadapter/appchain (SQLite materializer schema/data blobs)
- vms/chainadapter/messaging (conversation codec)
- staking/kms.go (KMS HTTP client — external technically, leave)
- utils/{bimap,ips} (small marshaler shims — low priority)
87 lines
1.9 KiB
Go
87 lines
1.9 KiB
Go
// Copyright (C) 2019-2025, Lux Industries Inc. All rights reserved.
|
|
// See the file LICENSE for licensing terms.
|
|
|
|
package status
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
|
|
"github.com/go-json-experiment/json"
|
|
"github.com/luxfi/node/vms/components/verify"
|
|
)
|
|
|
|
// List of possible blockchain status values:
|
|
// - [UnknownChain] This node is not aware of the existence of this blockchain
|
|
// - [Created] This node is not currently validating this blockchain
|
|
// - [Preferred] This blockchain is currently in the preferred tip
|
|
// - [Validating] This node is currently validating this blockchain
|
|
// - [Syncing] This node is syncing up to the preferred block height
|
|
const (
|
|
UnknownChain BlockchainStatus = iota
|
|
Created
|
|
Preferred
|
|
Validating
|
|
Syncing
|
|
)
|
|
|
|
var (
|
|
errUnknownBlockchainStatus = errors.New("unknown blockchain status")
|
|
|
|
_ json.Marshaler = BlockchainStatus(0)
|
|
_ verify.Verifiable = BlockchainStatus(0)
|
|
_ fmt.Stringer = BlockchainStatus(0)
|
|
)
|
|
|
|
type BlockchainStatus uint32
|
|
|
|
func (s BlockchainStatus) MarshalJSON() ([]byte, error) {
|
|
return []byte(`"` + s.String() + `"`), s.Verify()
|
|
}
|
|
|
|
func (s *BlockchainStatus) UnmarshalJSON(b []byte) error {
|
|
switch string(b) {
|
|
case `"Unknown"`:
|
|
*s = UnknownChain
|
|
case `"Created"`:
|
|
*s = Created
|
|
case `"Preferred"`:
|
|
*s = Preferred
|
|
case `"Validating"`:
|
|
*s = Validating
|
|
case `"Syncing"`:
|
|
*s = Syncing
|
|
case "null":
|
|
default:
|
|
return errUnknownBlockchainStatus
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// Verify that this is a valid status.
|
|
func (s BlockchainStatus) Verify() error {
|
|
switch s {
|
|
case UnknownChain, Created, Preferred, Validating, Syncing:
|
|
return nil
|
|
default:
|
|
return errUnknownBlockchainStatus
|
|
}
|
|
}
|
|
|
|
func (s BlockchainStatus) String() string {
|
|
switch s {
|
|
case UnknownChain:
|
|
return "Unknown"
|
|
case Created:
|
|
return "Created"
|
|
case Preferred:
|
|
return "Preferred"
|
|
case Validating:
|
|
return "Validating"
|
|
case Syncing:
|
|
return "Syncing"
|
|
default:
|
|
return "Invalid blockchain status"
|
|
}
|
|
}
|