PermissionObservation

Documentation for eth_defi.hyperliquid.permission.PermissionObservation Python class.

class PermissionObservation

Bases: object

A coherent source response or a retrospective uncertainty interval.

Legacy availability bounds are separate from exact response receipt times. Unknown flags in a successful response supersede older known flags.

Attributes summary

observation_id	Stable evidence identity; genuine new fetches receive distinct IDs.
vault_address	Lowercase Hypercore vault address.
record_kind	observation or uncertainty_boundary.
permission_observed_at	API receipt clock, or price clock for legacy_price_timestamp provenance.
written_at	Persistence time, separate from permission freshness.
evidence_available_at	Verified archive availability bound for deny-only evidence.
is_closed	Nullable closure flag from this same response.
allow_deposits	Nullable leader deposit-policy flag from this same response.
relationship_type	Vault relationship used to interpret the same capacity input.
leader_fraction	Recorded leader capital fraction, including recoverable archive values.
capacity_observed_at	Independent capacity receipt clock, absent for inferred flags.
provenance	Clock/evidence quality, including observed and legacy_price_timestamp.
source_endpoint	Origin of the retained source response or archive evidence.
collector_version	Collector schema/behaviour version for this record.
payload_json	Original coherent policy inputs or complete recovered source row.
payload_sha256	Digest of the retained payload text.
correction_parent_id	Earlier record superseded by an explicit correction, if supplied.
source_row_key	Original scanner/raw price key for inferred archive evidence.
effective_from	Start of a retrospective uncertainty interval, inclusive.
effective_to	End of a retrospective uncertainty interval, if bounded.
reason	Human-readable interpretation or uncertainty explanation.
max_deposit	Recorded trading-policy cap in USDC; zero is distinct from missing.

Methods summary

__init__(observation_id, vault_address[, ...])

observation_id: str

Stable evidence identity; genuine new fetches receive distinct IDs.

vault_address: eth_typing.evm.HexAddress

Lowercase Hypercore vault address.

record_kind: str

observation or uncertainty_boundary.

permission_observed_at: Optional[datetime.datetime]

API receipt clock, or price clock for legacy_price_timestamp provenance.

written_at: Optional[datetime.datetime]

Persistence time, separate from permission freshness.

evidence_available_at: Optional[datetime.datetime]

Verified archive availability bound for deny-only evidence.

is_closed: Optional[bool]

Nullable closure flag from this same response.

allow_deposits: Optional[bool]

Nullable leader deposit-policy flag from this same response.

relationship_type: Optional[str]

Vault relationship used to interpret the same capacity input.

leader_fraction: Optional[float]

Recorded leader capital fraction, including recoverable archive values.

capacity_observed_at: Optional[datetime.datetime]

Independent capacity receipt clock, absent for inferred flags.

provenance: str

Clock/evidence quality, including observed and legacy_price_timestamp.

source_endpoint: str

Origin of the retained source response or archive evidence.

collector_version: str

Collector schema/behaviour version for this record.

payload_json: str

Original coherent policy inputs or complete recovered source row.

payload_sha256: str

Digest of the retained payload text.

correction_parent_id: Optional[str]

Earlier record superseded by an explicit correction, if supplied.

source_row_key: Optional[str]

Original scanner/raw price key for inferred archive evidence.

effective_from: Optional[datetime.datetime]

Start of a retrospective uncertainty interval, inclusive.

effective_to: Optional[datetime.datetime]

End of a retrospective uncertainty interval, if bounded.

reason: Optional[str]

Human-readable interpretation or uncertainty explanation.

max_deposit: Optional[float]

Recorded trading-policy cap in USDC; zero is distinct from missing.

__init__(observation_id, vault_address, record_kind='observation', permission_observed_at=None, written_at=None, evidence_available_at=None, is_closed=None, allow_deposits=None, relationship_type=None, leader_fraction=None, capacity_observed_at=None, provenance='observed_unknown', source_endpoint='POST /info vaultDetails', collector_version='2', payload_json='{}', payload_sha256='', correction_parent_id=None, source_row_key=None, effective_from=None, effective_to=None, reason=None, max_deposit=None)

Parameters

• observation_id (str) –

• vault_address (eth_typing.evm.HexAddress) –

• record_kind (str) –

• permission_observed_at (Optional[datetime.datetime]) –

• written_at (Optional[datetime.datetime]) –

• evidence_available_at (Optional[datetime.datetime]) –

• is_closed (Optional[bool]) –

• allow_deposits (Optional[bool]) –

• relationship_type (Optional[str]) –

• leader_fraction (Optional[float]) –

• capacity_observed_at (Optional[datetime.datetime]) –

• provenance (str) –

• source_endpoint (str) –

• collector_version (str) –

• payload_json (str) –

• payload_sha256 (str) –

• correction_parent_id (Optional[str]) –

• source_row_key (Optional[str]) –

• effective_from (Optional[datetime.datetime]) –

• effective_to (Optional[datetime.datetime]) –

• reason (Optional[str]) –

• max_deposit (Optional[float]) –

Return type

None