Exceptions

In some cases it is necessary to interrupt the flow of execution with a failure: this is where the predefined function failwith comes in.

The failwith function

The failwith function raises an error that cannot be caught, which terminates the contract.

@entry
const main = (p: unit, s: unit) : [list<operation>, unit] =>
  failwith("This contract always fails");

The call to failwith sometimes needs to be annotated with a type when the type-checker cannot infer the correct type, e.g. return (failwith("message") : result);.

Assertions

Assertions can be used to ensure a certain condition is met when running a contract. The predefined function assert is used to check whether a given a Boolean condition is true. The function assert_some is used to check if an option value is not None. The function assert_some_with_error is like assert_some but an error message can be given. When a condition is not met, the contract will stop executing and display an error.

@entry
const main = (p: bool, s: unit) : [list<operation>, unit] => {
  let u: unit = assert(p);
  return [list([]), s];
};

@entry
const some = (o: option<unit>, s : unit) : [list<operation>, unit] => {
  assert_some(o);
  return [list([]), s]
};

You can use assert_with_error or assert_some_with_error to use a custom error message

@entry
let main = (p: bool, s: unit) : [list<operation>, unit] => {
  assert_with_error (p, "My custom error message.");
  return [list([]), s];
};