Skip to content

Releases: livepeer/go-livepeer

v0.5.22

28 Oct 21:17
@yondonfu yondonfu
v0.5.22
eb194bb
Compare
Choose a tag to compare
v0.5.22

Summary

This release includes an important MPEG-7 video signature capability fix, which is used for fast verification, for orchestrators/transcoders running on Windows. If you are running an orchestrator or transcoder on Windows you should upgrade to this release as soon as possible.

Additional highlights of this release:

  • Support for EIP-1559 (otherwise known as type 2) Ethereum transactions which results in more predictable transaction confirmation times, reduces the chance of stuck pending transactions and avoids overpaying in gas fees. If you are interested in additional details on the implications of EIP-1559 transactions refer to this resource.
  • An improvement in ticket parameter generation for orchestrators to prevent short lived gas price spikes on the Ethereum network from disrupting streams.
  • The node will automatically detect if the GPU enters an unrecoverable state and crash. The reason for crashing upon detecting an unrecoverable GPU state is that no transcoding will be possible in this scenario until the node is restarted. We recommend node operators to setup a process for monitoring if their node is still up and starting the node if it has crashed. For reference, a bash script similar to this one can be used to automate restarts of the node in the event of a crash.

Thanks to everyone that submitted bug reports and assisted in testing!

Features ⚒

General

  • #2013 Add support for EIP-1559 transactions (@yondonfu)
  • #2073 Make filtering orchestrators in the DB that haven't been updated in last day optional (@yondonfu)

Bug Fixes 🐞

Broadcaster

Orchestrator

  • #2071 Update tx cost check when generating ticket params to be more resistant to gas price spikes (@yondonfu)

Transcoder

  • #2057 Prevent stuck sessions by crashing on unrecoverable CUDA errors (@jailuthra)
  • #2066 Fix filename parsing errors for signature_cuda filter on Windows (@jailuthra)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: 89a2508944ab2725ce82b74597171a505a07423a86eecbdb65331fdd73aa68d7
  • livepeer-linux-amd64.tar.gz: 0c22bb2ea9413966371886673625395e5597ed903dcded51927dee1dd001aa1c
  • livepeer-windows-amd64.zip: 5e7e230e52fc5f477f0871efe72c641408afbbb5b7709e6c0f7af8844dc1d7b9

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>

Contributors

jailuthra, darkdarkdragon, and yondonfu
Assets 5
Loading

v0.5.21

29 Sep 21:29
@yondonfu yondonfu
v0.5.21
6ea2cf4
Compare
Choose a tag to compare
v0.5.21

Summary

This release includes a new orchestrator/transcoder MPEG-7 video signature capability which is required for broadcasters to run transcoding verification. The MPEG-7 video signatures are used as perceptual hashes in a "fast verification" algorithm that is described in the Fast and Full Transcoding Verification design. If a CPU is used for transcoding, the video signature computation will occur on the CPU. If a GPU is used for transcoding (i.e. the -nvidia flag is used), the video signature computation will occur on the GPU. Orchestrators and transcoders should upgrade to this release as soon as possible to ensure that they will be able to continue serving broadcasters that run fast verification (the complete broadcaster implementation will be shipped at a later date).

Orchestrators and transcoders should also make note of the breaking change in this release that drops support for Nvidia GPUs from the Kepler series.

Thanks to everyone that submitted bug reports and assisted in testing!

Breaking Changes 🚨🚨

  • #2027 Nvidia GPUs belonging to the Kepler series (GeForce 600, 700 series) and older, are no longer supported by go-livepeer. Cuda 11 is needed for newer GPUs, which only supports the Maxwell series or newer.

Features ⚒

General

Transcoder

  • #2036 Generate mpeg7 perceptual hashes for fast verification (@jailuthra)

Bug Fixes 🐞

Transcoder

  • #2027 Fix a memleak in the (experimental) AI content detection filter (@cyberj0g)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: 904866395dae2bf5f2dd386d73097ebfbc467c1424e78faf8e178578c806aa04
  • livepeer-linux-amd64.tar.gz: aa966e0af5599faf04d1c9334da36f59e3f6007ca23fc0f21c7c2379b998f0e4
  • livepeer-windows-amd64.zip: 5133cea0bed71cde18891e42908aaefa31bbf87b33b1434ba1cb11b260c75db8

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>

Contributors

jailuthra, Strykar, and cyberj0g
Assets 5
Loading

v0.5.20

13 Sep 17:55
@yondonfu yondonfu
v0.5.20
e54dec1
Compare
Choose a tag to compare
v0.5.20

Summary

This release includes a few important bug fixes including:

  • A fix for winning tickets incorrectly being marked as redeemed in the node's database even though they have not been redeemed yet
  • A fix for node crashes due to the submission of a replacement transaction when a max gas price is not configured
  • A fix for increased gas usage of reward transactions if an orchestrator did not receive stake updates in the previous round (via a reward call or delegation)

Additionally, this release includes a new -autoAdjustPrice flag that allows orchestrators to enable/disable automatic price adjustments based on the overhead for ticket redemption (which is determined by the current ETH gas price). Orchestrators can disable automatic price adjustments by setting -autoAdjustPrice=false (default is true) to ensure that they advertise a constant price to broadcasters avoiding the scenario where they lose all jobs due to a gas price spike that causes their advertised price to exceed the max price set by broadcasters. Refer to the docs for more information. If orchestrators disable automatic price adjustments then it is recommended to also use the -maxGasPrice flag to set a maximum gas price for transactions to wait to redeem tickets during lower gas prices periods.

We strongly recommend all orchestrator and transcoder operators to upgrade to this version to access this latest set of bug fixes and improvements.

Thanks to everyone that submitted bug reports and assisted in testing!

Features ⚒

Broadcaster

  • #1946 Send transcoding stream health events to a metadata queue (@victorges)

Orchestrator

  • #2025 Add -autoAdjustPrice flag to enable/disable automatic price adjustments (@yondonfu)

Transcoder

  • #1979 Upgrade to ffmpeg v4.4 and improved API for (experimental) AI tasks (@jailuthra)

Bug Fixes 🐞

General

Broadcaster

  • #2026 Run signature verification even without a verification policy specified (@yondonfu)

Orchestrator

  • #2018 Only mark tickets for failed transactions as redeemed when there is an error checking the transaction (@yondonfu)
  • #2029 Fix active total stake calculation when generating hints for rewardWithHint (@yondonfu)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: 22b4a7614d18e82986276c51340bd49515917f4689d146f69dd66e89dde762a0
  • livepeer-linux-amd64.tar.gz: 9a1e1af0867f1232152d538016515f20ca7c2728e7fe3492a85ec5a617676243
  • livepeer-windows-amd64.zip: 7ef76ae08da5631bed8b645710ca7a228d1b936083702f234b9885958703ef22

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>

Contributors

victorges, jailuthra, and 3 other contributors
Assets 5
Loading

v0.5.19

12 Aug 00:19
@yondonfu yondonfu
v0.5.19
d85a459
Compare
Choose a tag to compare
v0.5.19

Summary

This release includes another gas price monitoring fix to address additional cases where Ethereum JSON-RPC providers occassionally return really low gas prices for the eth_gasPrice RPC call, automatic replacements for pending transactions that timeout, fixes for broadcaster stream recording, support for downloading stream recordings as mp4 files as well as variety of other bug fixes and enhancements. We strongly recommend all orchestrator and transcoder operators to upgrade to this version to access this latest set of bug fixes and improvements.

In addition to the gas price monitoring fix and support for automatic replacements for pending transactions that timeout, a few additional configuration options are introduced to give node operators more control over gas prices and transactions:

  • -maxTransactionReplacements <INTEGER> can be used to specify the max number of times to replace a pending transaction that times out. The default value is 1.
  • -txTimeout <DURATION> can be used to specify the timeout duration for a pending transaction after which a replacement transaction would be submitted. The default value is 5m.
  • -minGasPrice <INTEGER> can be used to specify the minimum gas price (in wei) to use for transactions. The default is 1 gwei on mainnet.

More information about these new flags is accessible via livepeer -help.

The default value for the -maxTicketEV flag for broadcasters has been updated to 3000 gwei based on the default value of 1000 gwei for the -ticketEV flag for orchestrators which is safer for broadcasters. For more information on these default values, refer to the payment docs for video developers and the payment docs for video miners.

An experimental version of a deep neural network (DNN) based scene classification capability is mentioned in the changelog, but please note that while this is the first step towards enabling this capability on the network for video miners, this feature is NOT yet usable on the network today and is undergoing rapid development.

Thanks to everyone that submitted bug reports and assisted in testing!

Features ⚒

General

Broadcaster

Orchestrator

  • #1931 Bump ticket redemption gas estimate to 350k to account for occasional higher gas usage (@yondonfu)

Transcoder

Bug Fixes 🐞

General

  • #1968 Fix nil pointer error in embedded transaction receipts returned from the TransactionManager (@kyriediculous)
  • #1977 Fix error logging for failed replacement transaction (@yondonfu)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: dd907a0760104552bac1b59a453a25bcb1f0175f23ace74e8d3742322151719e
  • livepeer-linux-amd64.tar.gz: 76be58c81dd41f06c8bab6dacefc9815b4a3c2e85e3c4333ed0dd24c5c4769e5
  • livepeer-windows-amd64.zip: d1aafb9149bbf2440998918d5377529ee1c1efe88a25d09b162b5707b71f94e8

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>

Note: The Windows release was cut from a commit that was created after the v0.5.19 tagged commit because there was a Windows build process issue that needed to be fixed after the v0.5.19 commit. As a result, livepeer.exe -version will report 0.5.19-b6b17f1 instead of 0.5.19.

Contributors

jailuthra, darkdarkdragon, and 2 other contributors
Assets 5
Loading

v0.5.18

19 May 02:28
@yondonfu yondonfu
v0.5.18
41ebbc6
Compare
Choose a tag to compare
v0.5.18

Summary

This release includes an important fix that allows orchestrators to accurately set ticket face values (previously there were cases where orchestrators would inaccurately set ticket face values to a really low value) by discarding really low non-sensical gas prices returned by Ethereum JSON-RPC providers in the gas price monitor, reductions in the gas cost for staking actions (under certain circumstances) using livepeer_cli and improvements to split orchestrator and transcoder setups that help remote transcoders retain streams. We strongly recommend all orchestrator and transcoder operators to upgrade to this version as soon as possible to access this latest set of bug fixes and improvements.

Thanks to everyone that submitted bug reports and assisted in testing!

Breaking Changes 🚨🚨

  • Payment/ticket metrics are no longer recorded with high cardinality keys (i.e. recipient, manifestID) which means those labels will no longer be available when using a monitoring system such as Prometheus

Features ⚒

General

Broadcaster

Orchestrator

Transcoder

  • #1840 Automatically use all GPUs when -nvidia=all flag is set (@jailuthra)

Bug Fixes 🐞

Orchestrator

Transcoder

  • #1862 Report the correct FPS in outputs when FPS passthrough is enabled for GPU transcoding (@jailuthra)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: 710d1318155a3a6b1e58c079900b864fa1163c112058e448a75fbedf748eb31e
  • livepeer-linux-amd64.tar.gz: bb821290b3a3fa5862ff5d5f804c9f065420d45af8eabf238a3a25cdd333ce54
  • livepeer-windows-amd64.zip: 59a5029d2f6a7dcc1525e6ea4b1e88cd0fa0207c351d91eaa788ddf16b808bad

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>
Assets 5
Loading

v0.5.17

13 Apr 23:57
@yondonfu yondonfu
v0.5.17
3908252
Compare
Choose a tag to compare
v0.5.17

Summary

This release includes a few fixes for bugs that could cause nodes to crash due to race conditions and unexpected values returned by third party services (i.e. ETH JSON-RPC providers). We strongly recommend all node operators to upgrade to this version as soon as possible to access these bug fixes.

Thanks to everyone that submitted bug reports and assisted in testing!

Breaking Changes 🚨🚨

  • The deprecated -gasPrice, -s3bucket, -s3creds, -gsbucket and -gskey flags are now removed

Features ⚒

General

  • #1838 Remove deprecated flags: -gasPrice, -s3bucket, -s3creds, -gsbucket, -gskey (@kyriediculous)

Broadcaster

Bug Fixes 🐞

General

Orchestrator

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: 4a3d7d84a3c5b3ee68b86e90a9b8c7a85db6326fdb08ef75f26fe74f685781ef
  • livepeer-linux-amd64.tar.gz: 39dc144285e4ff661068685687d159b721f6f0fdc9d771af05e2f3f805d58f6e
  • livepeer-windows-amd64.zip: ba866f2a4f34d9af041fd2e3cc8133b9fbda36a6ad458f759fb65f959612093e

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>
Assets 5
Loading

v0.5.16

30 Mar 00:29
@yondonfu yondonfu
v0.5.16
4e24711
Compare
Choose a tag to compare
v0.5.16

Summary

This release includes an important fix for a bug that could cause broadcasters to crash due to missing data in responses from misconfigured orchestrators. We strongly recommend that all broadcaster operators upgrade to this version as soon as possible to access this bug fix.

If you are not a broadcaster operator, then upgrading to this release is not urgent.

Thanks to everyone that submitted bug reports and assisting in testing!

Bug Fixes 🐞

General

Broadcaster

  • #1782 Fix SegsInFlight data-loss on refreshing O sessions (@darkdragon)
  • #1814 Add price checks when caching orchestrator responses during discovery (@yondonfu)
  • #1818 Additional checks to avoid nil pointer errors caused by unexpected orchestrator configurations (@kyriediculous)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: d2a04478850a78d3427dc2b41d34b377cbba445def77bb6a44678ad949062ac7
  • livepeer-linux-amd64.tar.gz: 4de9e303b1ac6fd498da43d18bb74661c21e8b2494f6ace5e99d1621ff4e9c7d
  • livepeer-windows-amd64.zip: 92bf96ad391f2ebc3bd8b3132a86592deb46a8764de2c24cf521a7cf30c8b779

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>
Assets 5
Loading

v0.5.15

15 Mar 20:27
@yondonfu yondonfu
v0.5.15
eaf986b
Compare
Choose a tag to compare
v0.5.15

Summary

This release includes an important fix for a bug that could cause transcoding to become stuck for certain corrupt or unsupported source segments. As a result of this bug, some operators saw a high number of sessions in metrics reporting on their orchestrators or transcoders despite receiving a low amount of streams in practice. We strongly recommend that all orchestrator and transcoder operators upgrade to this version as soon as possible to access this bug fix.

Thanks everyone that submitted bug reports and assisted in testing!

Upcoming Changes

  • The following flags are pending deprecation and will be removed in the next release:
    • -gasPrice
    • -s3bucket
    • -s3creds
    • -gsbucket
    • -gskey

Features ⚒

General

Broadcaster

  • #1754 Count bytes of video data received/sent per stream and expose via the /status endpoint (@darkdragon)
  • #1764 Mark all input errors in LPMS as non-retryable during transcoding (@jailuthra)

Orchestrator

  • #1731 Add support for webhook to authenticate and set prices for broadcasters at the start of a session (@kyriediculous)
  • #1761 Add a livepeer_router binary that can route broadcasters to different orchestrators (@yondonfu)

Bug Fixes 🐞

General

  • #1729 Make sure the block watcher service can process multiple blocks in a single polling interval (@kyriediculous)
  • #1795 Fix Darwin build by changing optimization flag used for gnutls dependency (@iameli)

Broadcaster

Transcoder

  • #1775 Fix transcoder load balancer race condition around session cleanup (@jailuthra)
  • #1784 Use auth token sessionID to index into sessions map in transcoder load balancer (@jailuthra)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: 633e427d61a7f44d7c7613dc82843cdfdde2ff4f57285590e7245785e93f56b0
  • livepeer-linux-amd64.tar.gz: 1c34bc5424cf9c7f5cf546068e9f79c76a8406262a7dc4898dd18aae5d471db3
  • livepeer-windows-amd64.zip: e82ab83b238937129a6b70252d63aff720c4dabd8110d0d72632a0d012c2c7d5

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>
Assets 5
Loading

v0.5.14

03 Feb 19:04
@yondonfu yondonfu
v0.5.14
4df2453
Compare
Choose a tag to compare
v0.5.14

Summary

This release includes a few important bug fixes as well as some improvements to the consistency and reliability of the transcoding workflow between broadcasters and orchestrators. We strongly recommend that orchestrator operators upgrade to this version to access the bug fixes.

Thanks to everyone that submitted bug reports and assisted in testing!

Features ⚒

General

  • Support multiple segments in flight on both broadcasters and orchestrators (#1735 #1749)
    • The broadcaster will support multiple segments in flight for an orchestrator as long as the oldest segment is within the maximum in-flight time requirement which is currently set to the duration of the segment

Broadcaster

  • Record metrics when using the stream recording feature (#1710)
  • Record a metric for the number of swaps to different orchestrators for a stream (#1735)
  • Classify additional segment upload errors as timeouts when recording upload error metrics (#1717)
  • Reduce orchestrator discovery related logs by removing redundant logs and using the DEBUG logging level for certain logs (#1732)
  • Treat no keyframe errors from orchestrators as non-retryable errors (#1745)

Bug Fixes 🐞

Broadcaster

  • Fix 500 errors caused by concurrent HTTP push sessions that use the same internal manifestID (provided by a webhook) (#1706)

Orchestrator

  • Ensure that advertised ticket face values cover the estimated redemption tx cost (#1751)

Transcoder

  • Fix an issue where transcoding could get stuck if a segment without keyframes is received. Now, a no keyframe error is returned in stead (#1745 livepeer/lpms#220)
  • Fix an issue where Nvidia transcoding could get stuck if a segment contains invalid packets that trigger a Nvidia driver/CUDA error (#1753 livepeer/lpms#223)

Full list of changes

Verifying Release

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: a8156d54d3de5402b9b1d925591251a7c88e310d3155795c13ff6542fe09e3b8
  • livepeer-linux-amd64.tar.gz: 738a4919d88eca90b1f5f80c2f98ea47fbfac28a888c83dc6d93b9dacdb8c880
  • livepeer-windows-amd64.zip: d88ffe928d804571813e968b6a5e5a1addfd842cfde5a026105c9d101dcce2a9

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>
Assets 5
Loading

v0.5.13

14 Dec 21:22
@yondonfu yondonfu
v0.5.13
ce102b8
Compare
Choose a tag to compare
v0.5.13

Summary

This release includes a reduction in the # of ETH RPC requests (in the reward and round initializer services) required for an orchestrator (which should help when using ETH RPC providers such as Infura that have rate limit based usage plans), a new transcoding benchmarking tool livepeer_bench that orchestrators/transcoders can use to quantify their transcoding speed and set transcoding session limits, and a number of new node metrics that can be scraped using Prometheus. The adventurous can also check out a new experimental feature for broadcasters to record livestreams.

Thanks to everyone that submitted bug reports and assisted in testing!

Features

General

  • Add support for generic URL based object store syntax (#1582)
    • The -s3bucket/-s3creds and gsbucket/gskey flags are deprecated in favor of the -objectStore flag
  • Add livepeer_bench executable which can be used for transcoding benchmarking (#1676)
  • Clean up logging from ffmpeg libraries (#1678 livepeer/lpms#214)
  • Build Darwin and Linux binaries using >= go1.15.5 (#1677)
    • The go version for the Windows binary will be updated as will in a future release

Broadcaster

  • Record time to download renditions from orchestrator metric (#1654)
  • Return map of external manifestID (i.e. streamID) to internal manifestID (i.e. webhook manifestID) in /status response (#1662)
  • Add support for recording streams using a configurable recording object store using the -recordObjectStore flag or an objectStore field specified in an auth webhook response (#1582)
  • Add support for joining playlists for multiple transcoding sessions when generating a recording (#1674 #1679)

Orchestrator

  • Refactor reward service to reduce the # of ETH RPC requests required (#1696)
  • Refactor round initializer service to reduce the # of ETH RPC requests required (#1702)
  • Record time to transcode when using a remote transcoder metric (#1655)
  • Record time to download renditions from remote transcoder metric (#1655)
  • Record source segment duration metric (#1670)
  • Record time to download source segment from broadcaster metric (#1670)
  • Record transcode score (source segment duration / transcode time) metric (#1670)

Transcoder

  • Record time to transcode when using a Nvidia GPU metric (#1655)
  • Record time to upload renditions to orchestrator metric (#1655)

Full list of changes

Verifying Release

Note: As of this release, only the sha256 hash of the archive (containing all release binaries i.e. livepeer, livepeer_cli and livepeer_bench) will be published as a part of a release.

sha256 hashes for release archives:

  • livepeer-darwin-amd64.tar.gz: a4c7a946291389913f5d7f75657a89e4c2607cc54f22f055776b101be10cde65
  • livepeer-linux-amd64.tar.gz: b4ec825424c2298b8858d64c55faa8be7e6229efce3537f326e910d8705a909c
  • livepeer-windows-amd64.zip: 289b9a1ac211a16d19cf3ca3497b862b160c9ddc68f9c635b3664d08d69dee4f

Generate the sha256 hash:

shasum -a 256 livepeer-<PLATFORM>-amd64.<EXTENSION>
Assets 5
Loading