Basic

Abs

Name: Abs

Type: integer

Get the absolute value of an integer

Max

Name: Max

Type: integer

Get the largest item from a sequence of integers

Min

Name: Min

Type: integer

Get the smallest item from a sequence of integers

Sum

Name: Sum

Type: integer

Sum over a sequence of integers

Average

Name: Average

Type: integer

Get the average of a sequence of integers.

The average will be rounded down to the closest integer

Median

Name: Median

Type: integer

Get the median of a sequence of integers.

If the sequence has an even number of elements, the lower median will be returned

Flatten

Name: Flatten

Type: list<varies>

Flatten a list of lists.

Unique

Name: Unique

Type: list<varies>

Returns a version of the list where each element appears only once.

The order of the list is preserved. Each element appears at the index of its first occurrence

Len

Name: Len

Type: integer

Get the length of a list

Contains

Name: Contains

Type: boolean

Check whether an item is contained within a list

Zip

Name: Zip

Type: list<tuple<varies, varies>>

"Zip" together two lists of the same type (similar to python's zip method). If the optional truncate is true (defaults to false), the result's length is the minimum of the two. Otherwise, the two lists have to be the same length.

The return value would a list of tuples, each tuple holding 2 values, one from each list.

Unless truncate is set to true, Zip will fail if the two lists are not the same lengths.

source zipped: list<tuple<integer, boolean>> = Zip {
    first: list(1, 2, 3),
    second: list(true, true, false)
};

zipped == list(tuple(1, true), tuple(2, true), tuple(3, false))


source zipped: list<tuple<integer, boolean>> = Zip {
    first: list(1, 2, 3, 4), // extra item in list
    second: list(true, true, false),
    truncate: true
};

zipped == list(tuple(1, true), tuple(2, true), tuple(3, false))


// THE FOLLOWING EXAMPLE RESULTS IN AN EXCEPTION //
source zipped: list<tuple<integer, boolean>> = Zip {
    first: list(1, 2, 3, 4),
    second: list(true, true, false)
};

Aggregate

Name: Aggregate

Type: list<varies>

Aggregates the values of a data source over a specified window

The type of this source depends on the base source provided. See the Example section for more information.

Range

Name: Range

Type: list<integer>

Generate a list of integers within a specified range.

source numbers: list<integer> = Range {
    start: 0
    stop: 10
};

numbers == list(0, 1, 2, 3, 4, 5, 6, 7, 8, 9)

source even_numbers: list<integer> = Range {
    start: 0
    stop: 10
    step: 2
};

even_numbers == list(0, 2, 4, 6, 8)

Keccak256

Name: Keccak256

Type: bytes

Calculates the Keccak256 digest of a bytes data source.

source example_hash: bytes = Keccak256 {
    input: bytes(
        0xebca344cb8b39affb8e29bf4b0766fcdb8fb9b10ac6ac98dc2c24e8b6cb8ca02
    )
};


example_hash == bytes(
    0xeded37fef822d4be8e42d4e10772a2f8466cc287661c0fc7a2439205301c9684
)

Map Contains

Name: MapContains

Type: boolean

Checks if an items exists in a given map

Encode

Name: Encode

Type: bytes

Encode given parameters for a given function signature using ABI.encode

source dataBytes: bytes = Encode {
  data: tuple(1, "0xdAC17F958D2ee523a2206206994597C13D831ec7"),
 signature: "(uint256,address)"
};


dataBytes == bytes(
    0x0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7
)

Decode

Name: Decode

Type: tuple<varies>

0Decode given bytes to parameters of a given function signature using ABI.decode

Group

Name: Group

Type: map<varies | tuple<varies>, list<tuple<varies>>>

Group list items by a given criterion based on selected indices.

source transactions: list<tuple<address, address, integer>> = Events { ... }

source tx_by_addresses: map<tuple<address, address>, list<tuple<address, address, integer>>> = Group {
  sequence: transactions,
  by: tuple(0,1)
}

source tx_by_sum: map<integer, list<tuple<address, address, integer>>> = Group {
  sequence: transactions,
  by: 2
}

tx_by_addresses[tuple(0x0...001, 0x0...002)] == list(
  tuple(0x0...001, 0x0...002, 4756687),
  tuple(0x0...001, 0x0...002, 8696),
  ...
)

tx_by_sum[4756687] == list(
  tuple(0x0...001, 0x0...002, 4756687),
  tuple(0x0...009, 0x0...007, 4756687),
  ...
)

tx_by_sum[8696] == list(
  tuple(0x0...001, 0x0...002, 8696),
  tuple(0x0...004, 0x0...007, 8696),
  ...
)

MapContains {
  map: tx_by_addresses,
  item: tuple(0x0...001, 0x0...002)
} == true

PreviousData Sources NextArithmetic

Last updated 1 year ago