# next

Returns the next revision of a given revision if it exists.

# Type

next(rev: string): Promise<string | undefined>

# Parameters

# `rev`

A revision encoded as a string of the form <transaction-id>:<output-number>.

# Return Value

The next revision or undefined.

# Description

Given the revision of an on-chain object, the function returns the next revision of the same on-chain object. If no such revision exists because the revision passed in is a latest revision, undefined is returned.

# Example

import { Contract, Computer } from '@bitcoin-computer/lib'
import { chain, network, url, expect } from '../../utils'

// A smart contract
class Counter extends Contract {
  n: number

  constructor() {
    super({ n: 0 })
  }
  inc() {
    this.n += 1
  }
}

describe('next', () => {
  it('Should return the next revision', async () => {
    // Create and fund wallet
    const computer = new Computer({ chain, network, url })
    await computer.faucet(1e8)

    // Create on-chain object at counter._id
    const counter = await computer.new(Counter, [])

    // Update on-chain object, the new version is stores at counter._rev
    await counter.inc()

    // Check that the next revision of counter._id is counter._rev
    expect(await computer.next(counter._id)).eq(counter._rev)
  })
})

Sources