diff --git a/rpc/executables.go b/rpc/executables.go new file mode 100644 index 00000000..5e6cd7b9 --- /dev/null +++ b/rpc/executables.go @@ -0,0 +1,24 @@ +package rpc + +import ( + "context" + + "github.com/NethermindEth/juno/core/felt" +) + +// Get the contract class definition in the given block associated with the given hash +// +// Parameters: +// - ctx: The context.Context used for the request +// - classHash: The hash of the contract class whose CASM will be returned +// Returns: +// - *felt.Felt: The compiled contract class +// - error: An error if any occurred during the execution +func (provider *Provider) CompiledCasm(ctx context.Context, classHash *felt.Felt) (*felt.Felt, error) { + var result *felt.Felt + if err := do(ctx, provider.c, "starknet_getCompiledCasm", &result, classHash); err != nil { + + return nil, tryUnwrapToRPCErr(err, ErrContractNotFound, ErrBlockNotFound) + } + return result, nil +} diff --git a/rpc/types_contract.go b/rpc/types_contract.go index d7ea97b7..affc336c 100644 --- a/rpc/types_contract.go +++ b/rpc/types_contract.go @@ -69,7 +69,7 @@ type ContractClass struct { // The version of the contract class object. Currently, the Starknet OS supports version 0.1.0 ContractClassVersion string `json:"contract_class_version"` - EntryPointsByType EntryPointsByType `json:"entry_points_by_type"` + EntryPointsByType SierraEntryPointsByType `json:"entry_points_by_type"` ABI string `json:"abi,omitempty"` } @@ -285,7 +285,7 @@ type SierraEntryPoint struct { Selector *felt.Felt `json:"selector"` } -type EntryPointsByType struct { +type SierraEntryPointsByType struct { Constructor []SierraEntryPoint `json:"CONSTRUCTOR"` External []SierraEntryPoint `json:"EXTERNAL"` L1Handler []SierraEntryPoint `json:"L1_HANDLER"` diff --git a/rpc/types_executables.go b/rpc/types_executables.go new file mode 100644 index 00000000..eea0248d --- /dev/null +++ b/rpc/types_executables.go @@ -0,0 +1,300 @@ +package rpc + +import ( + "github.com/NethermindEth/juno/core/felt" +) + +type CasmCompiledContractClass struct { + EntryPointsByType CasmEntryPointsByType `json:"entry_points_by_type"` + ByteCode []*felt.Felt `json:"bytecode"` + Prime []*felt.Felt `json:"prime"` + CompilerVersion string `json:"compiler_version"` + Hints Hints `json:"hints"` + // a list of sizes of segments in the bytecode, each segment is hashed invidually when computing the bytecode hash + BytecodeSegmentLengths []int `json:"bytecode_segment_lengths,omitempty"` +} + +type CasmEntryPointsByType struct { + Constructor []CasmEntryPoint `json:"CONSTRUCTOR"` + External []CasmEntryPoint `json:"EXTERNAL"` + L1Handler []CasmEntryPoint `json:"L1_HANDLER"` +} + +type CasmEntryPoint struct { + DeprecatedCairoEntryPoint + // the hash of the right child + Builtin []string `json:"builtins"` +} + +// 2-tuple of pc value and an array of hints to execute, but adapted to a golang struct +type Hints struct { + Int int + HintArr []Hint +} + +func (hints *Hints) GetValues() (int, []Hint) { + return hints.Int, hints.HintArr +} + +type Hint any // TODO: finish the description and create an unmarshall func to every 'any' type + +type DeprecatedHint any // is one of these types: DeprecatedHintEnum, AssertAllAccessesUsed, AssertLtAssertValidInput, Felt252DictRead, or Felt252DictWrite + +type CoreHint any + +type StarknetHint any + +type DeprecatedHintEnum string + +const ( + AssertCurrentAccessIndicesIsEmpty DeprecatedHintEnum = "AssertCurrentAccessIndicesIsEmpty" + AssertAllKeysUsed DeprecatedHintEnum = "AssertAllKeysUsed" + AssertLeAssertThirdArcExcluded DeprecatedHintEnum = "AssertLeAssertThirdArcExcluded" +) + +type AssertAllAccessesUsed struct { + NotUsedAccesses CellRef `json:"n_used_accesses"` +} + +type CellRef struct { + Register Register `json:"Register"` + Offset int `json:"offset"` +} + +type Register string + +const ( + AP Register = "AP" + FP Register = "FP" +) + +type AssertLtAssertValidInput struct { + A ResOperand `json:"a"` + B ResOperand `json:"b"` +} + +type felt252Dict struct { + DictPtr ResOperand `json:"dict_ptr"` + Key ResOperand `json:"key"` +} + +type Felt252DictRead struct { + felt252Dict + ValueDst CellRef `json:"value_dst"` +} + +type Felt252DictWrite struct { + felt252Dict + Value ResOperand `json:"value"` +} + +type Felt252DictEntryInit felt252Dict + +type Felt252DictEntryUpdate struct { + DictPtr ResOperand `json:"dict_ptr"` + Value ResOperand `json:"value"` +} + +type ResOperand any // is one of these types: Deref, DoubleDeref, Immediate, or BinOp + +type Deref CellRef + +// A (CellRef, offsest) tuple, but adapted to a golang struct +type DoubleDeref struct { + CellRef CellRef + Offset int +} + +func (dd *DoubleDeref) GetValues() (CellRef, int) { + return dd.CellRef, dd.Offset +} + +type Immediate NumAsHex + +type Operation string + +const ( + Add Operation = "Add" + Mul Operation = "Mul" +) + +type BinOp struct { + Operation Operation `json:"op"` + A CellRef `json:"a"` + B any `json:"b"` // is one of these types: Deref or Immediate +} + +type AllocSegment struct { + Dst CellRef `json:"dst"` +} + +type baseLhsRhs struct { + Lhs ResOperand `json:"lhs"` + Rhs ResOperand `json:"rhs"` +} + +type TestLessThan struct { + baseLhsRhs + Dst CellRef `json:"dst"` +} + +type TestLessThanOrEqual TestLessThan + +type TestLessThanOrEqualAddress TestLessThan + +type WideMul128 struct { + baseLhsRhs + High CellRef `json:"high"` + Low CellRef `json:"low"` +} + +type DivMod struct { + baseLhsRhs + Quotient CellRef `json:"quotient"` + Remainder CellRef `json:"remainder"` +} + +type Uint256DivMod struct { + Dividend0 ResOperand `json:"dividend0"` + Dividend1 ResOperand `json:"dividend1"` + Divisor0 ResOperand `json:"divisor0"` + Divisor1 ResOperand `json:"divisor1"` + Quotient0 CellRef `json:"quotient0"` + Quotient1 CellRef `json:"quotient1"` + Remainder0 CellRef `json:"remainder0"` + Remainder1 CellRef `json:"remainder1"` +} + +type Uint512DivModByUint256 struct { + Uint256DivMod + Dividend2 ResOperand `json:"dividend2"` + Dividend3 ResOperand `json:"dividend3"` + Quotient2 CellRef `json:"quotient2"` + Quotient3 CellRef `json:"quotient3"` +} + +type SquareRoot struct { + Value ResOperand `json:"value"` + Dst CellRef `json:"dst"` +} + +type Uint256SquareRoot struct { + ValueLow ResOperand `json:"value_low"` + ValueHigh ResOperand `json:"value_high"` + Sqrt0 CellRef `json:"sqrt0"` + Sqrt1 CellRef `json:"sqrt1"` + RemainderLow CellRef `json:"remainder_low"` + RemainderHigh CellRef `json:"remainder_high"` + SqrtMul2MinusRemainderGeU128 CellRef `json:"sqrt_mul_2_minus_remainder_ge_u128"` +} + +type LinearSplit struct { + Value ResOperand `json:"value"` + Scalar ResOperand `json:"scalar"` + MaxX ResOperand `json:"max_x"` + X CellRef `json:"x"` + Y CellRef `json:"y"` +} + +type AllocFelt252Dict struct { + SegmentArenaPtr ResOperand `json:"segment_arena_ptr"` +} + +type GetSegmentArenaIndex struct { + DictEndPtr ResOperand `json:"dict_end_ptr"` + DictIndex CellRef `json:"dict_index"` +} + +type InitSquashDatas struct { + DictAccess ResOperand `json:"dict_access"` + PtrDiff ResOperand `json:"ptr_diff"` + NAccesses ResOperand `json:"n_accesses"` + BigKeys CellRef `json:"big_keys"` + FirstKeys CellRef `json:"first_key"` +} + +type GetCurrentAccessIndex struct { + RangeCheckPtr ResOperand `json:"range_check_ptr"` +} + +type GetCurrentAccessDelta struct { + IndexDeltaMinus1 CellRef `json:"index_delta_minus1"` +} + +type GetNextDictKey struct { + NextKey CellRef `json:"next_key"` +} + +type ShouldSkipSquashLoop struct { + ShouldSkipLoop CellRef `json:"should_skip_loop"` +} + +type ShouldContinueSquashLoop struct { + ShouldContinue CellRef `json:"should_continue"` +} + +type AssertLeFindSmallArcs struct { + RangeCheckPtr ResOperand `json:"range_check_ptr"` + A ResOperand `json:"a"` + B ResOperand `json:"b"` +} + +type AssertLeIsFirstArcExcluded struct { + SkipExcludeAFlag CellRef `json:"skip_exclude_a_flag"` +} + +type AssertLeIsSecondArcExcluded struct { + SkipExcludeBMinusA CellRef `json:"skip_exclude_b_minus_a"` +} + +type RandomEcPoint struct { + X CellRef `json:"x"` + Y CellRef `json:"y"` +} + +type FieldSqrt struct { + Val ResOperand `json:"val"` + Sqrt CellRef `json:"sqrt"` +} + +type DebugPrint struct { + Start ResOperand `json:"start"` + End ResOperand `json:"end"` +} + +type AllocConstantSize struct { + Size ResOperand `json:"size"` + Dst CellRef `json:"dst"` +} + +type U256InvModN struct { + B0 ResOperand `json:"b0"` + B1 ResOperand `json:"b1"` + N0 ResOperand `json:"n0"` + N1 ResOperand `json:"n1"` + G0OrNoInv CellRef `json:"g0_or_no_inv"` + G1Option CellRef `json:"g1_option"` + SOrR0 CellRef `json:"s_or_r0"` + SOrR1 CellRef `json:"s_or_r1"` + TOrR0 CellRef `json:"t_or_k0"` + TOrR1 CellRef `json:"t_or_k1"` +} + +type EvalCircuit struct { + NAddMods ResOperand `json:"n_add_mods"` + AddModBuiltin ResOperand `json:"add_mod_builtin"` + NMulMods ResOperand `json:"n_mul_mods"` + MulModBuiltin ResOperand `json:"mul_mod_builtin"` +} + +type SystemCall struct { + System ResOperand `json:"system"` +} + +type Cheatcode struct { + Selector NumAsHex `json:"selector"` + InputStart ResOperand `json:"input_start"` + InputEnd ResOperand `json:"input_end"` + OutputStart CellRef `json:"output_start"` + OutputEnd CellRef `json:"output_end"` +} diff --git a/utils/data.go b/utils/data.go index ce5d2098..4eae69e5 100644 --- a/utils/data.go +++ b/utils/data.go @@ -1,6 +1,9 @@ package utils -import "encoding/json" +import ( + "encoding/json" + "fmt" +) func UnwrapJSON(data map[string]interface{}, tag string) (map[string]interface{}, error) { if data[tag] != nil { @@ -16,3 +19,18 @@ func UnwrapJSON(data map[string]interface{}, tag string) (map[string]interface{} } return data, nil } + +func GetTypedFieldFromJSON[T any](data map[string]interface{}, tag string) (T, error) { + var resp T + rawResp, ok := data[tag] + if !ok { + return resp, fmt.Errorf("missing '%s' field in json object", tag) + } + + resp, ok = rawResp.(T) + if !ok { + return resp, fmt.Errorf("expected type '%T', got '%T'", resp, rawResp) + } + + return resp, nil +}