Struct gstd::prog::ProgramGenerator
source · pub struct ProgramGenerator(/* private fields */);
Expand description
Helper to create programs without setting the salt manually.
Implementations§
source§impl ProgramGenerator
impl ProgramGenerator
sourcepub fn get_salt() -> Vec<u8> ⓘ
pub fn get_salt() -> Vec<u8> ⓘ
Return the salt needed to create a new program.
Salt is an arbitrary byte sequence unique after every function call.
§Examples
use gstd::prog::ProgramGenerator;
#[no_mangle]
extern "C" fn handle() {
let salt = ProgramGenerator::get_salt();
}
sourcepub fn create_program_bytes(
code_id: CodeId,
payload: impl AsRef<[u8]>,
value: u128
) -> Result<(MessageId, ActorId)>
pub fn create_program_bytes( code_id: CodeId, payload: impl AsRef<[u8]>, value: u128 ) -> Result<(MessageId, ActorId)>
Create a new program from the already existing on-chain code identified
by CodeId
.
The function returns an initial message identifier and a newly created program identifier.
The first argument is the code identifier (see CodeId
for details).
The second and third arguments are the initialization message’s payload
and the value to be transferred to the new program.
§Examples
Create a new program from the provided code identifier:
use gstd::{msg, prog::ProgramGenerator, CodeId};
#[no_mangle]
extern "C" fn handle() {
let code_id: CodeId = msg::load().expect("Unable to load");
let (init_message_id, new_program_id) =
ProgramGenerator::create_program_bytes(code_id, b"INIT", 0)
.expect("Unable to create a program");
msg::send_bytes(new_program_id, b"PING", 0).expect("Unable to send");
}
sourcepub fn create_program_bytes_for_reply(
code_id: CodeId,
payload: impl AsRef<[u8]>,
value: u128,
reply_deposit: u64
) -> Result<CreateProgramFuture>
pub fn create_program_bytes_for_reply( code_id: CodeId, payload: impl AsRef<[u8]>, value: u128, reply_deposit: u64 ) -> Result<CreateProgramFuture>
Same as create_program_bytes
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
§See also
sourcepub fn create_program_bytes_for_reply_as<D: Decode>(
code_id: CodeId,
payload: impl AsRef<[u8]>,
value: u128,
reply_deposit: u64
) -> Result<CodecCreateProgramFuture<D>>
pub fn create_program_bytes_for_reply_as<D: Decode>( code_id: CodeId, payload: impl AsRef<[u8]>, value: u128, reply_deposit: u64 ) -> Result<CodecCreateProgramFuture<D>>
Same as create_program_bytes
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
The output should be decodable via SCALE codec.
§See also
sourcepub fn create_program_bytes_delayed(
code_id: CodeId,
payload: impl AsRef<[u8]>,
value: u128,
delay: u32
) -> Result<(MessageId, ActorId)>
pub fn create_program_bytes_delayed( code_id: CodeId, payload: impl AsRef<[u8]>, value: u128, delay: u32 ) -> Result<(MessageId, ActorId)>
Same as create_program_bytes
, but
creates a new program after the delay
expressed in block count.
sourcepub fn create_program_bytes_with_gas(
code_id: CodeId,
payload: impl AsRef<[u8]>,
gas_limit: u64,
value: u128
) -> Result<(MessageId, ActorId)>
pub fn create_program_bytes_with_gas( code_id: CodeId, payload: impl AsRef<[u8]>, gas_limit: u64, value: u128 ) -> Result<(MessageId, ActorId)>
Same as create_program_bytes
, but with
an explicit gas limit.
sourcepub fn create_program_bytes_with_gas_for_reply(
code_id: CodeId,
payload: impl AsRef<[u8]>,
gas_limit: u64,
value: u128,
reply_deposit: u64
) -> Result<CreateProgramFuture>
pub fn create_program_bytes_with_gas_for_reply( code_id: CodeId, payload: impl AsRef<[u8]>, gas_limit: u64, value: u128, reply_deposit: u64 ) -> Result<CreateProgramFuture>
Same as create_program_bytes_with_gas
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
§See also
sourcepub fn create_program_bytes_with_gas_for_reply_as<D: Decode>(
code_id: CodeId,
payload: impl AsRef<[u8]>,
gas_limit: u64,
value: u128,
reply_deposit: u64
) -> Result<CodecCreateProgramFuture<D>>
pub fn create_program_bytes_with_gas_for_reply_as<D: Decode>( code_id: CodeId, payload: impl AsRef<[u8]>, gas_limit: u64, value: u128, reply_deposit: u64 ) -> Result<CodecCreateProgramFuture<D>>
Same as create_program_bytes_with_gas
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
The output should be decodable via SCALE codec.
§See also
sourcepub fn create_program_bytes_with_gas_delayed(
code_id: CodeId,
payload: impl AsRef<[u8]>,
gas_limit: u64,
value: u128,
delay: u32
) -> Result<(MessageId, ActorId)>
pub fn create_program_bytes_with_gas_delayed( code_id: CodeId, payload: impl AsRef<[u8]>, gas_limit: u64, value: u128, delay: u32 ) -> Result<(MessageId, ActorId)>
Same as create_program_bytes_with_gas
, but
creates a new program after the delay
expressed in block count.
sourcepub fn create_program<E: Encode>(
code_id: CodeId,
payload: E,
value: u128
) -> Result<(MessageId, ActorId)>
pub fn create_program<E: Encode>( code_id: CodeId, payload: E, value: u128 ) -> Result<(MessageId, ActorId)>
Same as create_program_bytes
, but allows
initialize program with the encodable payload.
sourcepub fn create_program_for_reply<E: Encode>(
code_id: CodeId,
payload: E,
value: u128,
reply_deposit: u64
) -> Result<CreateProgramFuture>
pub fn create_program_for_reply<E: Encode>( code_id: CodeId, payload: E, value: u128, reply_deposit: u64 ) -> Result<CreateProgramFuture>
Same as create_program
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
§See also
sourcepub fn create_program_for_reply_as<E: Encode, D: Decode>(
code_id: CodeId,
payload: E,
value: u128,
reply_deposit: u64
) -> Result<CodecCreateProgramFuture<D>>
pub fn create_program_for_reply_as<E: Encode, D: Decode>( code_id: CodeId, payload: E, value: u128, reply_deposit: u64 ) -> Result<CodecCreateProgramFuture<D>>
Same as create_program
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
The output should be decodable via SCALE codec.
§See also
sourcepub fn create_program_delayed<E: Encode>(
code_id: CodeId,
payload: E,
value: u128,
delay: u32
) -> Result<(MessageId, ActorId)>
pub fn create_program_delayed<E: Encode>( code_id: CodeId, payload: E, value: u128, delay: u32 ) -> Result<(MessageId, ActorId)>
Same as create_program
, but creates a new
program after the delay
expressed in block count.
sourcepub fn create_program_with_gas<E: Encode>(
code_id: CodeId,
payload: E,
gas_limit: u64,
value: u128
) -> Result<(MessageId, ActorId)>
pub fn create_program_with_gas<E: Encode>( code_id: CodeId, payload: E, gas_limit: u64, value: u128 ) -> Result<(MessageId, ActorId)>
Same as create_program
, but with an explicit
gas limit.
sourcepub fn create_program_with_gas_for_reply<E: Encode>(
code_id: CodeId,
payload: E,
gas_limit: u64,
value: u128,
reply_deposit: u64
) -> Result<CreateProgramFuture>
pub fn create_program_with_gas_for_reply<E: Encode>( code_id: CodeId, payload: E, gas_limit: u64, value: u128, reply_deposit: u64 ) -> Result<CreateProgramFuture>
Same as create_program_with_gas
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
§See also
sourcepub fn create_program_with_gas_for_reply_as<E: Encode, D: Decode>(
code_id: CodeId,
payload: E,
gas_limit: u64,
value: u128,
reply_deposit: u64
) -> Result<CodecCreateProgramFuture<D>>
pub fn create_program_with_gas_for_reply_as<E: Encode, D: Decode>( code_id: CodeId, payload: E, gas_limit: u64, value: u128, reply_deposit: u64 ) -> Result<CodecCreateProgramFuture<D>>
Same as create_program_with_gas
, but the program
will interrupt until the reply is received.
Argument reply_deposit: u64
used to provide gas for
future reply handling (skipped if zero).
The output should be decodable via SCALE codec.
§See also
Auto Trait Implementations§
impl RefUnwindSafe for ProgramGenerator
impl Send for ProgramGenerator
impl Sync for ProgramGenerator
impl Unpin for ProgramGenerator
impl UnwindSafe for ProgramGenerator
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.