@connext/nxtp-txservice NPM | npm.io

2.4.0 • Published 10 days ago

Install

Weekly downloads

-

License

MIT

Repository

Last release

10 days ago

TransactionService

TransactionService is a transaction relayer that should work with any chain and ensure that a tx gets submitted.

Key differences with Vector

Impossible to double-collateralize: because of how the contracts are written, we do not have to ensure that a tx gets submitted to chain with only one nonce. Submitting multiple times will just result in a revert that can easily be handled.
No offchain DB -- the TransactionService should be fully stateless. The router (responsible for calling TransactionService) whould be responsible for calling TransactionService on init if there are pending transfers that need to be completed.
Should be as generalized as possible. Params should take in arbitrary calldata. That way, we can iterate on biz logic mostly inside the router and keep TransactionService untouched.

All in all, this means the TransactionService should be as "dumb" as possible. It should simply relay transactions to chain with gas bump + retries return a success EITHER when it notices an onchain event was emitted OR when the txs revert onchain bc they were already submitted.

It should also natively support multiple providers, rotating through them if it fails to receive success responses.

Dependencies

Services:

Chain RPC Providers
Signer
Config (contains multiple providers and block confirmation requirements per chain)

Params:

config:
log: Logger (BaseLog)
Signer

Each transaction method should take in as params:

chainId: chain ID number
tx: Tx to, from, data

Test Vectors

The fundamental design principle of the txService is that it should only handle chain-submission-related issues and nothing else. This will make it much easier to test.

We need to make sure that the txService is resilient to all sorts of possible chain-related failures:

Reorgs
Providers unresponsive
Providers returning errors
Providers out of sync with the chain
Txs underpriced
Txs stuck in mempool
Txs overpriced (max gas price)
Nonce already used

Bc the txService is fairly generalized, we should be able to easily unit test handling all of the above cases by writing a mock provider. We can pull logs from vector to understand more about what kinds of errors providers will return that we should be accounting for.

@connext/nxtp-utils @connext/smart-contracts @sinclair/typebox ajv ajv-formats ethers evt interval-promise p-queue

@infinitebrahmanuniverse/nolb-_conn @everything-registry/sub-chunk-195 crosschain-widget @connext/nxtp-sdk @connext/sdk-core @rabbitholegg/questdk-plugin-connext @fibswap2021/nxtp-sdk

10 days ago

1 month ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

5 months ago

7 months ago

10 months ago

6 months ago

6 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.2.8-alpha.3-test.2

1 year ago

0.2.8-alpha.3-test.1

1 year ago

0.2.8-alpha.3-test.0

1 year ago

1 year ago

0.2.8-alpha.3-test.3

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

0.2.8-alpha.3-test

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago