@aeternity/aepp-sdk 10.0.0 → 12.0.0

package/src/ae/aens.js

@@ -1,366 +0,0 @@
-/*
- * ISC License (ISC)
- * Copyright (c) 2018 aeternity developers
- *
- *  Permission to use, copy, modify, and/or distribute this software for any
- *  purpose with or without fee is hereby granted, provided that the above
- *  copyright notice and this permission notice appear in all copies.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
- *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
- *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
- *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
- *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
- *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- *  PERFORMANCE OF THIS SOFTWARE.
- */
-
-/**
- * Aens module - routines to interact with the æternity naming system
- *
- * The high-level description of the naming system is
- * https://github.com/aeternity/protocol/blob/master/AENS.md in the protocol
- * repository.
- * @module @aeternity/aepp-sdk/es/ae/aens
- * @export Aens
- * @example import { Aens } from '@aeternity/aepp-sdk'
- */
-
-import { salt } from '../utils/crypto'
-import {
-  commitmentHash, ensureNameValid, getMinimumNameFee, isAuctionName, encode, produceNameId
-} from '../tx/builder/helpers'
-import Ae from './'
-import { CLIENT_TTL, NAME_FEE, NAME_TTL } from '../tx/builder/schema'
-
-/**
- * Revoke a name
- * @instance
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @category async
- * @param {String} name Name hash
- * @param {Object} [options={}] options
- * @param {String|Object} [options.onAccount] Make operation on specific account from sdk (you pass
- * publickKey) or using provided KeyPair(Can be keypair object or MemoryAccount)
- * @param {Number|String|BigNumber} [options.fee] fee
- * @param {Number|String|BigNumber} [options.ttl] ttl
- * @param {Number|String|BigNumber} [options.nonce] nonce
- * @return {Promise<Object>} Transaction result
- * @example
- * const name = 'test.chain'
- * const nameObject = await sdkInstance.aensQuery(name)
- *
- * await sdkInstance.aensRevoke(name, { fee, ttl , nonce })
- * // or
- * await nameObject.revoke({ fee, ttl, nonce })
- */
-async function revoke (name, options = {}) {
-  ensureNameValid(name)
-  const opt = { ...this.Ae.defaults, ...options }
-
-  const nameRevokeTx = await this.nameRevokeTx({
-    ...opt,
-    nameId: produceNameId(name),
-    accountId: await this.address(opt)
-  })
-
-  return this.send(nameRevokeTx, opt)
-}
-
-/**
- * Update a name
- * @instance
- * @function
- * @category async
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @param {String} name AENS name
- * @param {Object.<string, string>} pointers Map of pointer keys to corresponding addresses
- * @param {Object} [options={}]
- * @param {Boolean} [options.extendPointers] Get the pointers from the node and merge with provided
- * ones. Pointers with the same type will be overwritten
- * @param {String|Object} [options.onAccount] Make operation on specific account from sdk (you
- * pass publickKey) or using provided KeyPair(Can be keypair object or MemoryAccount)
- * @param {Number|String|BigNumber} [options.fee] fee
- * @param {Number|String|BigNumber} [options.ttl] ttl
- * @param {Number|String|BigNumber} [options.nonce] nonce
- * @param {Number|String|BigNumber} [options.nameTtl=50000] Name ttl represented in number of
- * blocks (Max value is 50000 blocks)
- * @param {Number|String|BigNumber} [options.clientTtl=84600] a suggestion as to how long any
- * clients should cache this information
- * @return {Promise<Object>}
- * @throws Invalid pointer array error
- * @example
- * const name = 'test.chain'
- * const pointersArray = ['ak_asd23dasdas...,' 'ct_asdf34fasdasd...']
- * const nameObject = await sdkInstance.aensQuery(name)
- *
- * await sdkInstance.aensUpdate(name, pointersArray, { nameTtl, ttl, fee, nonce, clientTtl })
- * // or
- * await nameObject.update(pointers, { nameTtl, ttl, fee, nonce, clientTtl })
- */
-async function update (name, pointers = {}, options = {}) {
-  ensureNameValid(name)
-  const opt = { ...this.Ae.defaults, ...options }
-  const allPointers = {
-    ...options.extendPointers && Object.fromEntries(
-      (await this.getName(name)).pointers.map(({ key, id }) => [key, id])
-    ),
-    ...pointers
-  }
-
-  const nameUpdateTx = await this.nameUpdateTx({
-    ...opt,
-    nameId: produceNameId(name),
-    accountId: await this.address(opt),
-    pointers: Object.entries(allPointers).map(([key, id]) => ({ key, id }))
-  })
-
-  return this.send(nameUpdateTx, opt)
-}
-
-/**
- * Transfer a domain to another account
- * @instance
- * @function
- * @category async
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @param {String} name AENS name
- * @param {String} account Recipient account publick key
- * @param {Object} [options={}]
- * @param {String|Object} [options.onAccount] Make operation on specific account from sdk (you pass
- * publickKey) or using provided KeyPair(Can be keypair object or MemoryAccount)
- * @param {Number|String|BigNumber} [options.fee] fee
- * @param {Number|String|BigNumber} [options.ttl] ttl
- * @param {Number|String|BigNumber} [options.nonce] nonce
- * @return {Promise<Object>} Transaction result
- * @example
- * const name = 'test.chain'
- * const recipientPub = 'ak_asd23dasdas...'
- * const nameObject = await sdkInstance.aensQuery(name)
- *
- * await sdkInstance.aensTransfer(name, recipientPub, { ttl, fee, nonce })
- * // or
- * await nameObject.transfer(recipientPub, { ttl, fee, nonce })
- */
-async function transfer (name, account, options = {}) {
-  ensureNameValid(name)
-  const opt = { ...this.Ae.defaults, ...options }
-
-  const nameTransferTx = await this.nameTransferTx({
-    ...opt,
-    nameId: produceNameId(name),
-    accountId: await this.address(opt),
-    recipientId: account
-  })
-
-  return this.send(nameTransferTx, opt)
-}
-
-/**
- * Query the AENS name info from the node
- * and return the object with info and predefined functions for manipulating name
- * @instance
- * @function
- * @category async
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @param {String} name
- * @param {Object} opt Options
- * @return {Promise<Object>}
- * @example
- * const nameObject = sdkInstance.aensQuery('test.chain')
- * console.log(nameObject)
- * {
- *  id, // name hash
- *  pointers, // array of pointers
- *  update, // Update name function
- *  extendTtl, // Extend Ttl name function
- *  transfer, // Transfer name function
- *  revoke // Revoke name function
- * }
- */
-async function query (name, opt = {}) {
-  ensureNameValid(name)
-  const o = await this.getName(name)
-
-  return Object.freeze(Object.assign(o, {
-    pointers: o.pointers || [],
-    update: async (pointers, options = {}) => {
-      return {
-        ...(await this.aensUpdate(name, pointers, { ...opt, ...options })),
-        ...(await this.aensQuery(name))
-      }
-    },
-    transfer: async (account, options = {}) => {
-      return {
-        ...(await this.aensTransfer(name, account, { ...opt, ...options })),
-        ...(await this.aensQuery(name))
-      }
-    },
-    revoke: async (options = {}) => this.aensRevoke(name, { ...opt, ...options }),
-    extendTtl: async (nameTtl = NAME_TTL, options = {}) => {
-      if (!nameTtl || typeof nameTtl !== 'number' || nameTtl > NAME_TTL) throw new Error('Ttl must be an number and less then 180000 blocks')
-
-      return {
-        ...await this.aensUpdate(name, {}, { ...opt, ...options, nameTtl, extendPointers: true }),
-        ...await this.aensQuery(name)
-      }
-    }
-  }))
-}
-
-/**
- * Claim a previously preclaimed registration. This can only be done after the
- * preclaim step
- * @instance
- * @function
- * @category async
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @param {String} name
- * @param {Number} salt Salt from pre-claim, or 0 if it's a bid
- * @param {Object} [options] options
- * @param {String|Object} [options.onAccount] Make operation on specific account from sdk (you pass
- * publickKey) or using provided KeyPair(Can be keypair object or MemoryAccount)
- * @param {Number|String|BigNumber} [options.fee] fee
- * @param {Number|String|BigNumber} [options.ttl] ttl
- * @param {Number|String|BigNumber} [options.nonce] nonce
- * @param {Number|String} [options.nameFee] Name Fee (By default calculated by sdk)
- * @return {Promise<Object>} the result of the claim
- * @example
- * const name = 'test.chain'
- * const salt = preclaimResult.salt // salt from pre-claim transaction
- *
- * await sdkInstance.aensClaim(name, salt, { ttl, fee, nonce, nameFee })
- */
-async function claim (name, salt, options) {
-  ensureNameValid(name)
-  const opt = { ...this.Ae.defaults, ...options }
-
-  const minNameFee = getMinimumNameFee(name)
-  if (opt.nameFee !== this.Ae.defaults.nameFee && minNameFee.gt(opt.nameFee)) {
-    throw new Error(`the provided fee ${opt.nameFee} is not enough to execute the claim, required: ${minNameFee}`)
-  }
-  opt.nameFee = opt.nameFee !== this.Ae.defaults.nameFee ? opt.nameFee : minNameFee
-  const claimTx = await this.nameClaimTx({
-    ...opt,
-    accountId: await this.address(opt),
-    nameSalt: salt,
-    name: encode(name, 'nm')
-  })
-
-  const result = await this.send(claimTx, opt)
-  if (!isAuctionName(name)) {
-    const nameInter = opt.waitMined ? await this.aensQuery(name, opt) : {}
-    return Object.assign(result, nameInter)
-  }
-  return { ...result, nameFee: opt.nameFee }
-}
-
-/**
- * Preclaim a name. Sends a hash of the name and a random salt to the node
- * @instance
- * @function
- * @category async
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @param {String} name
- * @param {Object} [options={}]
- * @param {String|Object} [options.onAccount] Make operation on specific account from sdk (you pass
- * publickKey) or using provided KeyPair(Can be keypair object or MemoryAccount)
- * @param {Number|String|BigNumber} [options.fee] fee
- * @param {Number|String|BigNumber} [options.ttl] ttl
- * @param {Number|String|BigNumber} [options.nonce] nonce
- * @return {Promise<Object>}
- * @example
- * const name = 'test.chain'
- * const salt = preclaimResult.salt // salt from pre-claim transaction
- *
- * await sdkInstance.aensPreclaim(name, { ttl, fee, nonce })
- * {
- *   ...transactionResult,
- *   claim, // Claim function (options={}) => claimTransactionResult
- *   salt,
- *   commitmentId
- * }
- */
-async function preclaim (name, options = {}) {
-  ensureNameValid(name)
-  const opt = { ...this.Ae.defaults, ...options }
-  const _salt = salt()
-  const height = await this.height()
-  const commitmentId = commitmentHash(name, _salt)
-
-  const preclaimTx = await this.namePreclaimTx({
-    ...opt,
-    accountId: await this.address(opt),
-    commitmentId
-  })
-
-  const result = await this.send(preclaimTx, opt)
-
-  return Object.freeze({
-    ...result,
-    height,
-    claim: options => this.aensClaim(name, _salt, { ...options, onAccount: opt.onAccount }),
-    salt: _salt,
-    commitmentId
-  })
-}
-
-/**
- * Bid to name auction
- * @instance
- * @function
- * @category async
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @param {String} name Domain name
- * @param {String|Number} nameFee Name fee (bid fee)
- * @param {Object} [options={}]
- * @param {String|Object} [options.onAccount] Make operation on specific account from sdk (you pass
- * publickKey) or using provided KeyPair(Can be keypair object or MemoryAccount)
- * @param {Number|String|BigNumber} [options.fee] fee
- * @param {Number|String|BigNumber} [options.ttl] ttl
- * @param {Number|String|BigNumber} [options.nonce] nonce
- * @return {Promise<Object>} Transaction result
- * @example
- * const name = 'test.chain'
- * const bidFee = computeBidFee(name, startFee, incrementPercentage)
- *
- * await sdkInstance.aensBid(name, 213109412839123, { ttl, fee, nonce })
- */
-async function bid (name, nameFee = NAME_FEE, options = {}) {
-  return this.aensClaim(name, 0, { ...options, nameFee, vsn: 2 })
-}
-
-/**
- * Aens Stamp
- *
- * Aens provides name-system related methods atop
- * {@link module:@aeternity/aepp-sdk/es/ae--Ae} clients.
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/aens
- * @rtype Stamp
- * @param {Object} [options={}] - Initializer object
- * @return {Object} Aens instance
- */
-const Aens = Ae.compose({
-  methods: {
-    aensQuery: query,
-    aensPreclaim: preclaim,
-    aensClaim: claim,
-    aensUpdate: update,
-    aensTransfer: transfer,
-    aensRevoke: revoke,
-    aensBid: bid
-  },
-  deepProps: {
-    Ae: {
-      defaults: {
-        clientTtl: CLIENT_TTL,
-        nameTtl: NAME_TTL, // aec_governance:name_claim_max_expiration() => 50000
-        nameFee: NAME_FEE
-      }
-    }
-  }
-})
-
-export default Aens

package/src/ae/aepp.js

@@ -1,45 +0,0 @@
-/*
- * ISC License (ISC)
- * Copyright (c) 2018 aeternity developers
- *
- *  Permission to use, copy, modify, and/or distribute this software for any
- *  purpose with or without fee is hereby granted, provided that the above
- *  copyright notice and this permission notice appear in all copies.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
- *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
- *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
- *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
- *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
- *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- *  PERFORMANCE OF THIS SOFTWARE.
- */
-
-/**
- * Aepp module
- * @module @aeternity/aepp-sdk/es/ae/aepp
- * @export Aepp
- * @example import { RpcAepp } from '@aeternity/aepp-sdk'
- */
-
-import Ae from './'
-import Aens from './aens'
-import { ContractWithCompiler as Contract } from './contract'
-import AeppRpc from '../utils/aepp-wallet-communication/rpc/aepp-rpc'
-import Chain from '../chain/node'
-import Tx from '../tx/tx'
-import Oracle from './oracle'
-
-/**
- * Aepp Stamp
- *
- * Aepp provides base functionality.
- * Expected to use this stamp with a Wallet.
- * {@link module:@aeternity/aepp-sdk/es/ae--Ae} clients.
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/aepp
- * @rtype Stamp
- * @param {Object} [options={}] - Initializer object
- * @return {Object} Aepp instance
- */
-export default Ae.compose(Tx, Oracle, Contract, Aens, Chain, AeppRpc)

package/src/ae/contract.js

@@ -1,285 +0,0 @@
-/*
- * ISC License (ISC)
- * Copyright (c) 2018 aeternity developers
- *
- *  Permission to use, copy, modify, and/or distribute this software for any
- *  purpose with or without fee is hereby granted, provided that the above
- *  copyright notice and this permission notice appear in all copies.
- *
- *  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
- *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
- *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
- *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
- *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
- *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- *  PERFORMANCE OF THIS SOFTWARE.
- */
-
-/**
- * Contract module - routines to interact with the æternity contract
- *
- * High level documentation of the contracts are available at
- * https://github.com/aeternity/protocol/tree/master/contracts and
- *
- * @module @aeternity/aepp-sdk/es/ae/contract
- * @export Contract
- * @example import { Contract } from '@aeternity/aepp-sdk'
- */
-
-import Ae from './'
-import ContractCompilerAPI from '../contract/compiler'
-import ContractBase from '../contract'
-import getContractInstance from '../contract/aci'
-import NodePool from '../node-pool'
-import { AMOUNT, DEPOSIT, GAS, MIN_GAS_PRICE } from '../tx/builder/schema'
-import { decode, produceNameId } from '../tx/builder/helpers'
-
-/**
- * Static contract call(using dry-run)
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @category async
- * @deprecated
- * @param {String} source Contract source code
- * @param {String} contractAddress Contract address
- * @param {String} name Name of function to call
- * @param {Array} args Arguments array for call/deploy transaction
- * @param {Object} [options]
- * @param {Number|String} [options.top] Block height or hash on which you want to call contract
- * @param {String} [options.bytecode] Block hash on which you want to call contract
- * @param {Object} [options.filesystem] Contract external namespaces map
- * @return {Promise<Object>} Result object
- * @example
- * const callResult = await client.contractCallStatic(source, address, fnName, args)
- * {
- *   result: TX_DATA,
- *   decode: (type) => Decode call result
- * }
- */
-async function contractCallStatic (source, contractAddress, name, args = [], options) {
-  const contract = await this.getContractInstance({ ...options, source, contractAddress })
-  return contract.call(name, args, { ...options, callStatic: true })
-}
-
-/**
- * Call contract function
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @category async
- * @deprecated
- * @param {String} source Contract source code
- * @param {String} contractAddress Contract address or AENS name
- * @param {String} name Name of function to call
- * @param {Array} args Arguments array for call/deploy transaction
- * @param {Object} [options] Transaction options (fee, ttl, gas, amount, deposit)
- * @param {Object} [options.filesystem] Contract external namespaces map
- * @return {Promise<Object>} Result object
- * @example
- * const callResult = await client.contractCall(source, address, fnName, args = [], options)
- * {
- *   hash: TX_HASH,
- *   result: TX_DATA,
- *   decode: (type) => Decode call result
- * }
- */
-async function contractCall (source, contractAddress, name, args, options) {
-  const contract = await this.getContractInstance({ ...options, source, contractAddress })
-  return contract.call(name, args, options)
-}
-
-/**
- * Deploy contract to the node
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @category async
- * @deprecated
- * @param {String} code Compiled contract
- * @param {String} source Contract source code
- * @param {Array} params Arguments of contract constructor(init) function. Can be array of
- * arguments or callData string
- * @param {Object} [options] Transaction options (fee, ttl, gas, amount, deposit)
- * @param {Object} [options.filesystem={}] Contract external namespaces map*
- * @return {Promise<Object>} Result object
- * @example
- * const deployed = await client.contractDeploy(bytecode, source, init = [], options)
- * {
- *   owner: OWNER_PUB_KEY,
- *   transaction: TX_HASH,
- *   address: CONTRACT_ADDRESS,
- *   createdAt: Date,
- *   result: DEPLOY_TX_DATA,
- *   call: (fnName, args = [], options) => Call contract function,
- *   callStatic: (fnName, args = [], options) => Static all contract function
- * }
- */
-async function contractDeploy (code, source, params, options) {
-  const contract = await this.getContractInstance({ ...options, source })
-  contract.bytecode = code
-  return contract.deploy(params, options)
-}
-
-/**
- * Compile contract source code
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @category async
- * @param {String} source Contract sourece code
- * @param {Object} [options={}] Transaction options (fee, ttl, gas, amount, deposit)
- * @param {Object} [options.filesystem={}] Contract external namespaces map*
- * @return {Promise<Object>} Result object
- * @example
- * const compiled = await client.contractCompile(SOURCE_CODE)
- * {
- *   bytecode: CONTRACT_BYTE_CODE,
- *   deploy: (init = [], options = {}) => Deploy Contract,
- *   encodeCall: (fnName, args = []) => Prepare callData
- * }
- */
-async function contractCompile (source, options = {}) {
-  const opt = { ...this.Ae.defaults, ...options }
-  const bytecode = await this.compileContractAPI(source, options)
-  return Object.freeze({
-    encodeCall: (name, args) => this.contractEncodeCallDataAPI(source, name, args, opt),
-    deploy: (init, options) => this.contractDeploy(bytecode, source, init, { ...opt, ...options }),
-    deployStatic: (init, options) => this.contractCallStatic(source, null, 'init', init, {
-      ...opt,
-      ...options,
-      bytecode
-    }),
-    bytecode
-  })
-}
-
-/**
- * Utility method to create a delegate signature for a contract
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @category async
- * @param {String[]} ids The list of id's to prepend
- * @param {Object} [opt={}] options
- * @param {{ onAccount: String | Object }} [opt={}] opt Options
- * @return {Promise<String>} Signature in hex representation
- */
-async function delegateSignatureCommon (ids = [], opt = {}) {
-  const signature = await this.sign(
-    Buffer.concat([
-      Buffer.from(this.getNetworkId(opt)),
-      ...(Object.prototype.hasOwnProperty.call(opt, 'onAccount') ? [decode(await this.address(opt))] : []),
-      ...ids.map(e => decode(e))
-    ]),
-    opt
-  )
-  return Buffer.from(signature).toString('hex')
-}
-
-/**
- * Helper to generate a signature to delegate pre-claim/claim/transfer/revoke of a name to
- * a contract.
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @category async
- * @param {String} contractId Contract Id
- * @param {String} [name] The name
- * @param {{ onAccount: String | Object }} [opt={}] opt Options
- * @return {Promise<String>} Signature for delegation
- * @example
- * const client = await Universal({ ... })
- * const contractId = 'ct_asd2ks...' // contract address
- * const name = 'example.chain' // AENS name
- * const onAccount = await client.address() // Sign with a specific account
- * // Preclaim signature
- * const params = { contractId }
- * const preclaimSig = await client.createAensDelegationSignature(params, { onAccount: current })
- * // Claim, transfer and revoke signature
- * const params = { contractId, name }
- * const aensDelegationSig = await contract.createAensDelegationSignature(
- *   params, name, { onAccount: current }
- * )
- */
-async function createAensDelegationSignature ({ contractId, name }, opt = {}) {
-  return this.delegateSignatureCommon([...name ? [produceNameId(name)] : [], contractId], opt)
-}
-
-/**
- * Helper to generate a signature to delegate register/extend/respond of a Oracle to a contract.
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @category async
- * @param {String} contractId Contract Id
- * @param {String} [queryId] Oracle Query Id
- * @param {{ onAccount: String | Object }} [opt={}] opt Options
- * @return {Promise<String>} Signature for delegation
- * @example
- * const client = await Universal({ ... })
- * const contractId = 'ct_asd2ks...' // contract address
- * const queryId = 'oq_...' // Oracle Query Id
- * const onAccount = await client.address() // Sign with a specific account
- * // Oracle register and extend signature
- * const params = { contractId }
- * const oracleDelegationSig = await contract.createOracleDelegationSignature(params, { onAccount })
- * // Oracle respond signature
- * const params = { contractId, queryId }
- * const respondSig = await contract.createOracleDelegationSignature(params, queryId)
- */
-async function createOracleDelegationSignature ({ contractId, queryId }, opt = {}) {
-  return this.delegateSignatureCommon([...queryId ? [queryId] : [], contractId], opt)
-}
-
-/**
- * Contract Stamp
- *
- * Provide contract implementation
- * {@link module:@aeternity/aepp-sdk/es/ae--Ae} clients.
- * @function
- * @alias module:@aeternity/aepp-sdk/es/ae/contract
- * @rtype Stamp
- * @param {Object} [options={}] - Initializer object
- * @return {Object} Contract instance
- * @example
- * import Transaction from '@aeternity/aepp-sdk/es/tx/tx
- * import MemoryAccount from '@aeternity/aepp-sdk/es/account/memory
- * import ChainNode from '@aeternity/aepp-sdk/es/chain/node
- * import ContractCompilerAPI from '@aeternity/aepp-sdk/es/contract/compiler
- * // or using bundle
- * import {
- *   Transaction,
- *   MemoryAccount,
- *   ChainNode,
- *   ContractCompilerAPI
- * } from '@aeternity/aepp-sdk
- *
- * const ContractWithAE = await Contract
- *    .compose(Transaction, MemoryAccount, ChainNode) // AE implementation
- *    .compose(ContractCompilerAPI) // ContractBase implementation
- * const client = await ContractWithAe({ url, internalUrl, compilerUrl, keypair, ... })
- *
- */
-export const ContractAPI = Ae.compose(ContractBase, {
-  methods: {
-    getContractInstance,
-    contractCompile,
-    contractCallStatic,
-    contractDeploy,
-    contractCall,
-    // Delegation for contract
-    delegateSignatureCommon,
-    // AENS
-    createAensDelegationSignature,
-    // Oracle
-    createOracleDelegationSignature
-  },
-  deepProps: {
-    Ae: {
-      defaults: {
-        deposit: DEPOSIT,
-        gasPrice: MIN_GAS_PRICE,
-        amount: AMOUNT,
-        gas: GAS
-      }
-    }
-  }
-})
-
-export const Contract = ContractAPI.compose(NodePool)
-export const ContractWithCompiler = Contract.compose(ContractCompilerAPI)
-export default ContractWithCompiler